YMX怎么配置广告位？主题前端广告位显示教程

YMX 主题内置了一套完整的广告位系统，覆盖文章列表、文章正文、导航栏、归档页、侧边栏等多个位置。所有广告位都在后台统一配置，支持图文卡片广告、文字广告，以及可粘贴任意广告联盟代码的「代码广告位」，并自动区分 PC 端和手机端。下面按后台实际配置项逐一说明。

一、广告位设置入口

登录 WordPress 后台，进入 YMX主题设置 页面，在左侧竖向标签栏中找到并点击 「广告位设置」。页面顶部是该标签下的所有配置项，修改完成后点击右上角的 「保存更改」 按钮即可生效。

广告位设置整体分为三类：卡片广告（全站主列表第3个文章后）、文字广告（文章正文结尾），以及 14 处代码广告位。

二、全站主列表第3个文章后广告（卡片广告）

这个广告位会以「文章卡片」的样式，插入到全站文章列表的第 3 篇文章之后（首页最新文章、分类、标签等列表均生效）。配置项如下：

配置项	选项 ID	类型	默认值	说明
显示	ymx_ad_after_third_post	复选框	开启（true）	勾选后在第 3 篇文章后显示广告卡片
标题	ymx_ad_title	文本框	yimenapp前端H5混合开发，原生编译	广告卡片的标题文字
描述	ymx_ad_description	多行文本	（一段长介绍）	广告卡片的描述文字
链接	ymx_ad_link	文本框	https://www.yimenapp.com	点击卡片跳转的地址
图片	ymx_ad_image	上传	主题内置 ad.png	广告卡片缩略图

行为说明：

• 描述文字在前端会自动截断：超过 80 个字符时，只显示前 80 个字符并追加「…」。
• 卡片是否显示缩略图，取决于主题「列表模式」设置：只有列表模式为「缩略图」时才显示图片。
• 卡片上的「广告」角标由主题自动添加，无需手动填写。
• 点击卡片是否新窗口打开，跟随主题全局的「文章新窗口打开」设置。

三、文章页正文结尾文字广告

在每篇文章正文结束后、评论区之前，可插入一条纯文字广告（带「广告」标识）。配置项如下：

配置项	选项 ID	类型	默认值	说明
显示	ymx_ad_post_content_end	复选框	关闭（false）	勾选后在文章正文结尾显示文字广告
前标题	ymx_ad_post_content_end_pretitle	文本框	yimenapp	广告主标题前的小字
标题	ymx_ad_post_content_end_title	文本框	一门APP打包平台	广告主标题文字
链接	ymx_ad_post_content_end_link	文本框	（空）	点击跳转地址，留空则显示为纯文字
新窗口打开链接	ymx_ad_post_content_end_target	复选框	开启（true）	勾选后链接在新窗口打开

行为说明：

• 填写了「链接」时，前标题 + 标题会包裹成超链接；留空链接则显示为普通文字。
• 前端会自动渲染「广告」小标签，与正文明显区分。

四、代码广告位（14 处）

这是 YMX 最灵活的广告能力：在指定位置直接粘贴广告联盟代码或自定义 HTML/短代码。每一处都由「启用开关 + PC 端代码 + 手机端代码」组成（个别位置只有 PC 端代码框）。

通用规则：

• 代码框支持短代码（内部通过 do_shortcode 解析），可直接填写 [短代码]。
• 同时填写 PC 端和手机端代码时，主题会自动按设备切换显示对应代码；只填 PC 端代码时，该代码在所有设备显示（以具体位置为准）。
• 每个代码框都标注了「建议尺寸」，方便你准备相应宽度的广告素材。

完整代码广告位清单

位置名称	启用开关 ID	PC 端代码 ID	手机端代码 ID	建议尺寸（PC）
全站导航上	ymx_ad_header_top_enable	ymx_ad_header_top_code	—（仅 PC）	1920px 宽
全站导航下	ymx_ad_header_bottom_enable	ymx_ad_header_bottom_code	ymx_ad_header_bottom_mobile_code	1920px 宽
首页导航下	ymx_ad_home_nav_bottom_enable	ymx_ad_home_nav_bottom_code	ymx_ad_home_nav_bottom_mobile_code	1920px 宽
首页文章列表上	ymx_ad_home_list_top_enable	ymx_ad_home_list_top_code	ymx_ad_home_list_top_mobile_code	820px 宽
分类页列表上	ymx_ad_category_list_top_enable	ymx_ad_category_list_top_code	ymx_ad_category_list_top_mobile_code	820px 宽
标签页列表上	ymx_ad_tag_list_top_enable	ymx_ad_tag_list_top_code	ymx_ad_tag_list_top_mobile_code	820px 宽
搜索页列表上	ymx_ad_search_list_top_enable	ymx_ad_search_list_top_code	ymx_ad_search_list_top_mobile_code	820px 宽
作者页列表上	ymx_ad_author_list_top_enable	ymx_ad_author_list_top_code	ymx_ad_author_list_top_mobile_code	820px 宽
产品分类页左侧下	ymx_ad_product_category_left_bottom_enable	ymx_ad_product_category_left_bottom_code	ymx_ad_product_category_left_bottom_mobile_code	280px 宽
首页分页下	ymx_ad_home_list_bottom_enable	ymx_ad_home_list_bottom_code	ymx_ad_home_list_bottom_mobile_code	820px 宽
文章页正文上	ymx_ad_single_content_top_enable	ymx_ad_single_content_top_code	ymx_ad_single_content_top_mobile_code	760px 宽
文章页评论上	ymx_ad_single_comments_top_enable	ymx_ad_single_comments_top_code	ymx_ad_single_comments_top_mobile_code	760px 宽
文章正文第二段落后	ymx_ad_single_content_second_paragraph_enable	ymx_ad_single_content_second_paragraph_code	ymx_ad_single_content_second_paragraph_mobile_code	760px 宽
文章页正文下	ymx_ad_single_content_bottom_enable	ymx_ad_single_content_bottom_code	ymx_ad_single_content_bottom_mobile_code	760px 宽

手机端代码框的建议尺寸统一为 640px 宽，高度随意。

几个需要留意的位置

• 全站导航上：位于页面 <body> 之后、站点导航栏之前，只有 PC 端代码框，适合放顶部通栏横幅广告。
• 全站导航下 / 首页导航下：分别渲染在导航栏下方。其中「首页导航下」仅在首页/文章首页显示；这两处在「会员中心页」和「找回密码页」会自动跳过，不显示广告。
• 文章正文第二段落后：通过正则把广告插入到正文前两个 <p> 段落之后。如果正文不足两个段落，则该广告不会出现。

五、侧边栏广告小工具（YMX广告）

除了后台的固定广告位，YMX 还提供一个可拖拽的侧边栏小工具。进入 外观 → 小工具，找到 「YMX广告」，拖到任意侧边栏即可。

小工具字段	说明
广告名称	便于后台识别的名称，不显示在前端
广告代码	广告内容，支持 HTML
分类目录限制	控制广告在哪些分类下显示/隐藏（见下方规则）

分类目录限制规则（ID 之间用空格隔开）：

• 填正数，如 1 2 3：在 ID 为 1、2、3 的分类及其文章页隐藏广告。
• 填负数，如 -1 -2：仅在 ID 为 1、2 的分类及其文章页显示广告。
• 留空：所有页面均显示广告。