MorphSwift 产品文档

MorphSwift 文档中心与技术知识库

从安装配置到商城、商品分类、短代码和页面搭建，按任务完成 MorphSwift 站点设置。

延伸阅读官方资料：WordPress 开发者资源、WordPress Hooks 手册、Core Web Vitals 指标。

请从目录中选择章节开始阅读

短代码总览

短代码使用分类短代码小工具调用与代码模板文件调用，代码文件

调用方式	适用位置	示例
小工具调用	页面编辑器、短代码区块、文本小工具	[ms_breadcrumb]
代码模板调用	PHP模板文件、主题组件	<?php echo do_shortcode(‘[ms_breadcrumb]‘);?>

使用短代码时，将形如 [ms_field key="hero_title"] 的标记放入支持短代码的编辑器、页面模板或内容区块中。下方按功能列出 MorphSwift 当前注册的主题短代码；进入具体条目可查看用途、基础语法、字段默认值和可选值。字段读取类短代码应根据当前文章、产品或分类上下文使用，导航和表单类短代码则适合放在主题布局或对应功能区域。

自定义类型

名称	标签	用途
自定义字段	ms_field	读取文章、页面、商品或分类中的单个自定义字段
自定义群组	ms_field_group	读取一个自定义字段组，适合模板或组件批量读取字段。

页面与内容

名称	标签	用途
面包屑	ms_breadcrumb	输出当前页面的面包屑导航，帮助用户了解当前页面位置。
文章列表	ms_posts	输出文章列表。
联系表单	ms_contact_form	输出后台配置的联系表单。

导航组件

名称	标签	用途
导航购物车	ms_navbar_cart	在导航栏中输出购物车入口。
导航搜索	ms_navbar_search	在导航栏中输出搜索入口或搜索框。
导航登录	ms_navbar_login	输出登录、注册或账户入口。

商品展示与筛选

名称	标签	用途
完整商店列表	sc_shop	输出完整商品商店页面，包括商品列表、筛选、排序和分页。
商品网格	sc_products	在首页、营销页面或普通内容页中嵌入商品网格。
商品分类列表	sc_product_categories	输出商品分类卡片或分类列表。
商品筛选栏	sc_product_filters	输出商品分类、价格和排序筛选控件。
产品详情	sc_product_detail	输出单个商品的完整详情内容。
相关产品	sc_related_product	输出当前商品的相关商品。

购物车与结账

名称	标签	用途
购物车	sc_cart	输出完整购物车页面。
结账页	sc_checkout	输出完整结账流程。
结账联系信息	sc_checkout_contact	只输出结账页面的联系信息区域。
结账支付方式	sc_checkout_payment	输出支付方式选择区域。
订单摘要	sc_checkout_summary	输出当前订单摘要。
结账提交按钮	sc_checkout_submit	输出结账提交按钮。
订单详情	sc_checkout_order	输出订单完成后的订单详情。

组件展示

名称	标签	用途
组件预览	mk_preview	输出 MorphKits 组件预览内容。

商品展示

[sc_shop] 商店列表

用途：输出完整商品商店页面，包括商品列表、筛选、排序和分页。

字段	默认值	说明
`layout`	空	商店布局
`product_show_type`	空	商品展示类型
`limit`	空	商品数量
`pagination`	空	是否启用分页
`per_page`	空	每页数量
`card_style`	空	商品卡片样式
`card_min_width`	空	卡片最小宽度
`grid_gap`	空	网格间距
`image_ratio`	空	图片比例
`image_fit`	空	图片填充方式
`show_category`	空	显示分类
`show_excerpt`	空	显示摘要
`excerpt_length_mode`	空	摘要长度模式
`excerpt_length`	空	摘要长度
`show_badge`	空	显示徽章
`hover_lift`	空	是否启用悬浮效果
`add_to_cart_label`	空	加入购物车按钮文字

[sc_products] 商品网格

用途：在首页、营销页面或普通内容页中嵌入商品网格。

字段	默认值	说明
`limit`	`3`	商品数量。
`category`	`0`	商品分类 ID 或 slug。
`ids`	空	商品 ID，逗号分隔。
`orderby` / `order`	`menu_order` / `ASC`	排序字段和方向。
`card_style`	当前设置	商品卡片样式。
`show_category`	当前设置	是否显示卡片分类。
`show_excerpt`	当前设置	是否显示摘要。
`add_to_cart_label`	当前设置	加入购物车按钮文案。

[sc_product_categories] 商品分类列表

用途：输出商品分类卡片或分类列表。

字段	默认值	说明
`categories`	空	分类列表
`ids`	空	分类 ID
`limit`	`0`	数量，0 表示不限制
`class`	`sc-product-categories`	CSS 类名
`image_size`	`large`	分类图片尺寸
`show_button`	`true`	是否显示按钮
`button_label`	`浏览分类`	按钮文字

[sc_product_filters] 商品筛选栏

用途：输出商品分类、价格和排序筛选控件。

字段	默认值	说明
`fields`	`category,price,sort`	筛选字段
`action`	空	表单提交地址
`class`	`sc-product-filters`	CSS 类名
`category_label`	`分类`	分类标签
`all_label`	`全部`	全部分类文字
`price_label`	`价格`	价格标签
`sort_label`	`排序`	排序标签
`submit_label`	`应用`	应用按钮文字
`clear_label`	`清除`	清除按钮文字
`layout`	`select`	布局方式
`categories`	空	指定分类
`sorts`	`menu_order,date,title,price_asc,price_desc`	排序选项
`count_label`	`Count`	数量标签
`count_suffix`	`件`	数量单位

[sc_product_detail] 产品详情

用途：输出单个商品的完整详情内容。

字段	默认值	说明
`id`	`0`	商品 ID；留空时使用当前产品上下文。
`title`	`0`	显示商品标题。
`tags`	`0`	显示商品标签。
`price`	`0`	显示商品价格。
`excerpt`	`0`	显示商品摘要。
`detail_buttons`	`0`	显示购买、加入购物车等详情操作按钮。
`description`	`0`	显示商品描述。
`description_style`	`section`	描述布局，可选 `section` 或 `inline`。
`gallery`	`0`	显示商品图库。
`gallery_thumbnails`	`0`	显示图库缩略图。
`specs`	`0`	显示产品数据中的规格与选项、尺寸表和套装信息。
`modules`	`0`	显示产品数据中配置的扩展模块，例如问答、视频和文档列表。

[sc_related_product]

用途：输出当前商品的相关商品。

字段	默认值	说明
`id`	`0`
`limit`	`4`
`title`	`相关产品`
`title_tag`	`h2`
`image`	空
`tags`	空
`price`	空
`button`	空
`excerpt`	空
`orderby`	`date`
`order`	`DESC`
`card_style`	空
`class`	`sc-shop__grid`
`empty_text`	空

购物车与结账

[sc_cart] 购物车

用途：输出完整购物车页面。

[sc_checkout] 结账页

用途：输出完整结账流程。

字段	默认值	说明
`contact_info`	`1`	是否显示联系信息
`payment_methods`	空	支付方式
`order_summary`	`1`	是否显示订单摘要
`coupon`	`1`	是否显示优惠码
`submit_button`	`1`	是否显示提交按钮

[sc_checkout_contact] 结账联系信息

用途：只输出结账页面的联系信息区域。

[sc_checkout_payment] 结账支付方式

用途：输出支付方式选择区域。

字段	默认值	说明
`payment_methods`	空	使用后台启用的全部支付方式

[sc_checkout_summary] 订单摘要

用途：输出当前订单摘要。

[sc_checkout_submit] 结账提交按钮

用途：输出结账提交按钮。

[sc_checkout_order] 订单详情

用途：输出订单完成后的订单详情。

自定义类型

[ms_field]自定义字段

用途：读取文章、页面、产品或分类中的单个字段。

字段	默认值	可选值/说明
key	空	字段键，必填
post_id	空	指定文章/产品 ID
term_id	空	指定分类项 ID
taxonomy	空	分类法，如 category
return	空	图片字段支持 url、id
size	full	图片尺寸

[ms_field_group]自定义字段组

用途：读取一个自定义字段组，适合模板或组件批量读取字段。

字段	默认值	说明
`key`	空	字段组键
`post_id`	空	指定文章、页面或产品 ID
`term_id`	空	指定分类项 ID
`taxonomy`	`category`	分类法名称

页面与内容

[ms_breadcrumb] 面包屑导航

用途：输出当前页面的面包屑导航，帮助用户了解当前页面位置。

字段	默认值	说明
`template`	空	模板文件名，例如 `page-shop`
`in_main`	`0`	是否放入主内容区域
`force`	`0`	是否强制显示
`show_home`	空	是否显示首页入口

[ms_contact_form]联系表单

用途：输出后台配置的联系表单。

字段	默认值	可选值
`slug`	`default`	后台表单标识
`layout`	`auto`	`auto`、`stack`、`split`

[ms_posts]文章列表

用途：输出文章列表。

字段	默认值	说明
`limit`	`-1`	显示数量，-1为显示全部
`orderby`	空	排序字段
`order`	`DESC`	排序方向
`category`	空	分类
`tag`	空	标签
`post_type`	`post`	内容类型
`ids`	空	指定文章 ID
`offset`	`0`	偏移数量
`show_thumbnail`	空	是否显示缩略图
`show_excerpt`	空	是否显示摘要
`show_date`	空	是否显示日期
`class`	空	自定义 CSS 类名

导航组件

[ms_navbar_cart] 导航购物车

用途：在导航栏中输出购物车入口。

字段	默认值	可选值
`variant`	`icon`	`icon`、`inline`

[ms_navbar_search] 导航搜索

用途：在导航栏中输出搜索入口或搜索框。

字段	默认值	可选值
`variant`	`icon`	`icon`、`inline`

[ms_navbar_login] 导航登录

用途：输出登录、注册或账户入口。

字段	默认值	可选值
`variant`	`icon`	`icon`、`trigger`、`panel-row`

需要完整授权？

获取 MorphSwift 授权，解锁六大行业模板、SwiftCart 商业链路与 Pro 扩展能力。

浏览模板库获取授权

MorphSwift 文档中心与技术知识库

文档章节

短代码总览

自定义类型

页面与内容

导航组件

商品展示与筛选

购物车与结账

组件展示

商品展示

[sc_shop] 商店列表

[sc_products] 商品网格

[sc_product_categories] 商品分类列表

[sc_product_filters] 商品筛选栏

[sc_product_detail] 产品详情

[sc_related_product]

购物车与结账

[sc_cart] 购物车

[sc_checkout] 结账页

[sc_checkout_contact] 结账联系信息

[sc_checkout_payment] 结账支付方式

[sc_checkout_summary] 订单摘要

[sc_checkout_submit] 结账提交按钮

[sc_checkout_order] 订单详情

组件预览

[mk_preview] 组件预览

自定义类型

[ms_field]自定义字段

[ms_field_group]自定义字段组

页面与内容

[ms_breadcrumb] 面包屑导航

[ms_contact_form]联系表单

[ms_posts]文章列表

导航组件

[ms_navbar_cart] 导航购物车

[ms_navbar_search] 导航搜索

[ms_navbar_login] 导航登录

需要完整授权？