CoopCycle餐厅配置实战5步搞定菜单、商品与在线点餐的完整教程【免费下载链接】coopcycle-webLogistics marketplace platform. Only for worker-owned business.项目地址: https://gitcode.com/gh_mirrors/co/coopcycle-webCoopCycle 是一个面向工人合作社的自托管外卖配送平台让本地餐厅提供在线点餐由自行车骑手完成配送。本教程带你完成CoopCycle 餐厅配置从创建餐厅、设置营业时间到搭建菜单商品、开通在线点餐与支付5 个步骤即可让一家餐厅在平台上开张营业 一、先认识餐厅模块代码在哪里CoopCycle 的餐厅相关功能集中在以下目录配置界面与逻辑一一对应方便你按图索骥功能关键文件说明餐厅页面路由src/Controller/RestaurantController.php餐厅展示、购物车、下单入口餐厅配置表单src/Form/RestaurantType.php后台所有餐厅配置字段的定义餐厅前台页面templates/restaurant/index.html.twig顾客看到的餐厅主页菜单分区渲染templates/restaurant/_partials/menu_content.html.twig按分类展示菜品功能验收用例features/foodtech.feature点餐流程的自动化测试场景 小提示餐厅Restaurant与商店Store在 CoopCycle 中是同一套本地商户模型的两种形态后台配置方式基本一致。二、第 1 步创建餐厅并填写基础信息进入后台「商户 → 餐厅」页面点击新建。核心字段如下定义见 src/Form/RestaurantType.php餐厅类型type普通餐厅或商店形态描述description会展示在餐厅主页是吸引顾客的第一段文案经营地址businessAddress支持不同营业时间使用不同地址useDifferentBusinessAddress适合周末市集这类场景主打标签featured平台推荐位与exclusive平台独家可提升曝光菜系cuisines用于按菜系找餐厅的筛选页面。配置完成后餐厅主页会自动生成SEO 结构化数据Schema.org 微数据帮助餐厅被搜索引擎准确识别——这一逻辑就在 templates/restaurant/index.html.twig 中实现。三、第 2 步设置营业时间与配送方式在线点餐的体验核心在于什么时候能点、送到哪里。营业时间餐厅的营业时段支持细到每一天的开闭店时间前台会展示现在营业中/休息中状态模板见 templates/restaurant/_partials/opening_hours.html.twig。配送方式与预订延迟在fulfillmentMethods配送方式集合中可为餐厅单独配置外卖配送开启后可设置orderingDelayMinutes预订延迟分钟数例如提前 30 分钟接单前台会自动显示温馨提示到店自取骑手不参与的纯自提场景每日配送范围dayOfWeekDeliveryPerimeterExpressions支持按星期几绘制不同配送多边形区域。四、第 3 步搭建菜单——先分类后商品CoopCycle 菜单是分区Taxon→ 商品Product两级结构创建菜单分区如前菜主食饮品入口为后台餐厅详情下的菜单分类管理templates/restaurant/menu_taxons.html.twig每个分区可写一句介绍语添加商品在分区下创建商品templates/restaurant/products.html.twig填写名称、价格、描述并可上传图片商品选项通过商品选项product options实现加一份芝士去冰这类定制项上架控制商品可独立启用/停用下架即从菜单消失无需删除数据。前台菜单会按分区渲染成响应式卡片网格超过 10 个商品后自动懒加载保证页面秒开见 templates/restaurant/_partials/menu_content.html.twig五、第 4 步开通在线点餐与支付菜单就绪后剩下两步让餐厅真正开张结账与购物车顾客点选商品后进入购物车基于 Sylius 订单组件实现系统会实时计算最早可送达时间。下单逻辑入口在 src/Controller/RestaurantController.php 的 JSON 结账接口中购物车、送达时间、订单凭证一次返回。支付方式在餐厅配置表单的支付区块src/Form/RestaurantType.php可按需开启支付方式配置项适用场景货到付款cashOnDeliveryEnabled无需任何支付集成最快上手Stripe 分账allowStripeConnect线上信用卡收款平台抽佣Paygreen 企业支付usePaygreen面向企业客户Swile 餐券支付组件支持企业餐券结算✅新手推荐路径先开货到付款验证流程再接 Stripe 实现线上收款。六、第 5 步营销与运营加分项开张之后这些配置能让生意更好促销活动创建限时优惠并设为主打推广餐厅主页顶部会自动展示优惠横幅自动接单开启autoAcceptOrdersEnabled后订单直接进入配送队列适合成熟商户可复用包装押金depositRefundEnabled支持押金退还流程呼应 CoopCycle 的环保理念 数据统计后台餐厅统计页可查看订单量与收入趋势。平台整体由 Web API、前端与配送算法三部分组成完整架构可参考 docs/img/technical-overview.png 对应的技术概览文档 docs/img/七、本地部署快速开始想亲手试一遍克隆仓库并用 Docker 一键启动git clone https://gitcode.com/gh_mirrors/co/coopcycle-web cd coopcycle-web cp .env.dist .env docker compose up详细说明见项目根目录的 README.md。启动后用管理员账号登录按上面 5 个步骤配置你的第一家餐厅即可 常见问题 FAQQ1餐厅和商店有什么区别两者共用同一套商户模型与配置界面主要差异是菜系、菜单分区等餐饮专属字段仅餐厅可见。Q2可以只开自取不开配送吗可以。在配送方式集合中仅保留到店自取即可前台会自动隐藏配送相关选项。Q3配置错了能回滚吗商品、分区均支持停用而非删除误操作时先下架排查数据不会丢失。总结本文带你完成了CoopCycle 餐厅配置的全流程创建餐厅 → 营业时间与配送区域 → 菜单分区与商品 → 在线点餐与支付 → 营销运营。掌握这 5 步你就能在自托管的 CoopCycle 平台上开出第一家线上餐厅把外卖业务交还给社区与骑手 ‍♂️【免费下载链接】coopcycle-webLogistics marketplace platform. Only for worker-owned business.项目地址: https://gitcode.com/gh_mirrors/co/coopcycle-web创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考