双柚主题

给文章页中在随机位置插入指定内容，一个醒目的外框用以区别下方、还得有标签提示、图片、文本、链接，经过半天的努力终于弄出了初版（说是初版其实已经实现了我设想中的全部功能）

增加过期广告自动发送邮件通知，每条广告只会发送一次通知（只改动了后台和功能代码，CSS文件无变化）

根据文章长度自动选择广告插入的位置，如果是较短文章则在文章末尾

后台选项

如果后台放置了多个广告且都没超期，则前端每次刷新会随机显示任意一条广告

一、在func.php中插入以下代码

后台相关代码

class ZXM_CFS_Module
{
    public static function zxm_wzads()
    {
        $currentTimestamp = current_time('timestamp');  // 获取当前时间并转换为Unix时间戳
        $current_time = date("Y-m-d H:i:s",$currentTimestamp);  // 将当前时间戳转换为时间格式

        // 计算 7 天后的时间戳
        $sevenDaysLaterTimestamp = strtotime('+7 days', $currentTimestamp);
        
        // 将 7 天后的时间戳格式化为 Y-m-d H:i:s 格式
        $sevenDaysLaterTime = date('Y-m-d H:i:s', $sevenDaysLaterTimestamp);
        
        $f_imgpath = get_template_directory_uri() . '/inc/csf-framework/assets/images/';
        $args      = array();
        $args[] = array(
            'id'           => 'zwzsz',
            'type'         => 'text',
            'title'        => '广告主',
            'desc'         => '输入投放广告的单位，方便查找管理',
            'default'      => '上网的蜗牛',
        );
        $args[] = array(
            'title'   => __('广告图片','zib_language'),
            'id'      => 'zwzimg',
            'desc'         => '上传广告图片，宽度1200，高度最大150',
            'default' => '',
            'preview' => true,
            'library' => 'image',
            'type'    => 'upload',
        );
        $args[] = array(
            'id'           => 'zwztxt',
            'type'         => 'textarea',
            'title'        => '广告文本',
            'desc'         => '广告文本部分内容',
            'default'      => '上网的蜗牛文章内广告文本',
            'rows' => 4,
        );
        $args[] = array(
            'id'           => 'zwzurl',
            'type'         => 'text',
            'title'        => '广告链接',
            'desc'         => '广告图片的跳转URL，只需填网址就行，不用加代码',
            'default'      => 'https://wpa.qq.com/msgrd?v=3&uin=1278731729&site=qq&menu=yes&jumpflag=1',
        );
        $args[] = array(
            'id'           => 'zwzstart',
            'type'         => 'text',
            'title'        => '广告生效时间',
            'desc'         => '广告在网站显示的起始时间，如果只填日期则默认为当天的23:59:59',
            'default'      => $current_time,
        );
        $args[] = array(
            'id'           => 'zwzend',
            'type'         => 'text',
            'title'        => '广告到期时间',
            'desc'         => '广告在网站显示的截止时间，超过这个时间广告就不会显示，默认为7天后，如果只填日期则默认为当天的23:59:59',
            'default'      => $sevenDaysLaterTime,
        );
        return $args;
    }
}

$prefix = 'zibll_options';
$imagepath = '';
//CSF后台选项开始 zuoxm
CSF::createSection($prefix, array(
    'id'    => 'ZUOXM_CUSTOMIZE',
    'title' => '蜗牛自定义',
    'icon'  => 'fa fa-fw fa-puzzle-piece',
));
CSF::createSection($prefix, array(
    'parent' => 'ZUOXM_CUSTOMIZE',
    'id' => 'ZUOXM_WZADS',
    'title' => '蜗牛文章页广告管理',
    'icon'  => 'fa fa-fw fa-bell-o',
    'description' => '',
    'fields' => array(
        array(
            'type'    => 'notice',
            'style'   => 'warning',
            'content' => '<p><b>文章页广告管理页面</b></p><li style="color:blue">作者：<a href="https://www.hmoban.com" target="blank">Hi模板网</a></li><li style="color:blue">QQ：1278731729</li><li style="color:blue">QQ交流群：392272145</li>',
        ),
        array(
            'id'    => 'ZUOXM_WZADS_OPEN',
            'type'  => 'switcher',
            'title' => '文章页广告开关',
            'label' => '是否开启文章页广告位',
            'desc'  => '这是控制文章页广告位的总开头，打开后文章页广告位才会显示，关闭了则全部文章页广告不显示',
            'default' => '1',
        ),
        array(
            'id'           => 'ZUOXM_WZADS_EMAIL',
            'type'         => 'text',
            'title'        => '接收邮箱',
            'desc'         => '用来接收通知的E-MAIL',
            'default'      => '这里是接收邮件的邮箱，自行更改',
            'class'       => 'compact',
        ),
        array(
            'dependency'  => array('ZUOXM_WZADS_OPEN', '!=', ''),
            'id'           => 'ZUOXM_WZNADS',
            'type'         => 'group',
            'button_title' => '添加文章页广告项目',
            'title'        => '文章页广告位',
            'subtitle'     => '文章页广告位管理',
            'desc'         => '文章页广告位项目管理，你可以在此处新增、修改、删除文章页广告内容',
            'default'      => array(
                    'zwzsz'         => 'Hi模板网',
                    'zwzimg'       => $imagepath . '',
                    'zwztxt'       => '上文章内广告文本',
                    'zwzurl'       => 'https://wpa.qq.com/msgrd?v=3&uin=12334&site=qq&menu=yes&jumpflag=1',
                    'zwzstart'      => '2024-01-01 00:00:00',
                    'zwzend'       => '2026-01-01 23:59:59',
            ),
            
            'fields'       => ZXM_CFS_Module::zxm_wzads(),
        ),
    ),
));

功能代码

//文章页插入广告开始 zuoxm
add_filter('the_content', 'zxm_wz_ads', 15);
function zxm_wz_ads($content) {
    if (_pz('ZUOXM_WZADS_OPEN')) {
        $zwzfields = _pz('ZUOXM_WZNADS');
        if (!empty($zwzfields)) {
            $current_time = current_time('timestamp');  // 获取当前时间并转换为Unix时间戳
            $sent_ads = get_option('zxm_expired_ads_sent', array());
            $new_sent_ads = array();
            $expired_ads = array(); // 存储本次检测到的过期广告

            // 检测过期广告
            foreach ($zwzfields as $ad_item) {
                if (!empty($ad_item['zwzstart']) && !empty($ad_item['zwzend'])) {
                    $start = strtotime($ad_item['zwzstart']);
                    $end = strtotime($ad_item['zwzend']);
                    
                    if ($start === false || $end === false) continue;

                    if ($current_time > $end) {
                        $ad_key = md5($ad_item['zwzsz'] .$ad_item['zwzstart'] . $ad_item['zwzend'] . $ad_item['zwzurl']);
                        
                        if (!isset($sent_ads[$ad_key])) {
                            $expired_ads[] = $ad_item; // 记录过期广告
                            $new_sent_ads[$ad_key] = time(); // 记录需要更新的key
                        }
                    }
                }
            }

            // 发送合并邮件
            if (!empty($expired_ads)) {
                $to = _pz('ZUOXM_WZADS_EMAIL'); // 用来接收通知的邮箱
                $subject = '文章页广告已过期通知';
                $message = "<h2>以下【" . count($expired_ads) . "】条广告已超过结束时间</h2>";
                
                // 构建邮件内容
                foreach ($expired_ads as $index => $ad) {
                    $message .= sprintf(
                        "<h3>广告 %d：</h3><span style='color: #007BFF;font-weight:bold;'>广告标题：%s</span><br><span style='color: #007BFF;font-weight:bold;'>广告内容：</span>%s<br><span style='color: #007BFF;font-weight:bold;'>开始时间：</span>%s<br><span style='color: #007BFF;font-weight:bold;'>结束时间：</span>%s<br><hr>",
                        $index + 1,
                        $ad['zwzsz'] ,
                        $ad['zwztxt'] . $ad['zwzurl'],
                        $ad['zwzstart'],
                        $ad['zwzend']
                    );
                }
                $message .= "\n请及时处理！";
                
                // 发送邮件
                if (wp_mail($to, $subject, $message)) {
                    // 发送成功后更新记录
                    update_option('zxm_expired_ads_sent', array_merge($sent_ads, $new_sent_ads));
                }
            }
            // 筛选逻辑：仅验证时间范围（不检查其他字段）
            $new_zwzfields = array_filter($zwzfields, function($ad_item) use ($current_time) {
                // 仅当同时存在 zwzstart 和 zwzend 时验证时间
                if (!empty($ad_item['zwzstart']) && !empty($ad_item['zwzend'])) {
                    $start = strtotime($ad_item['zwzstart']);
                    $end = strtotime($ad_item['zwzend']);
                    // 时间转换失败则直接过滤该广告
                    if ($start === false || $end === false) return false;
                    
                    // 关键修正：严格校验时间区间
                    return ($current_time >= $start) && ($current_time <= $end);
                }
                // 未设置时间或只设置一个时间字段 → 保留广告
                return true;
            });
            
            if (!empty($new_zwzfields)) {
                $random_wzad = $new_zwzfields[array_rand($new_zwzfields)];
                $random_wztu = $random_wzad['zwztxt'] . '<a href="' . esc_url($random_wzad['zwzurl']) . '" target="_blank">' . esc_html($random_wzad['zwzurl']) . '</a>';
            
                if (is_single() && !is_admin()) {
                    // 引用 CSS 文件
                    wp_enqueue_style('zxm_random_ad', get_stylesheet_directory_uri() . '/zxm_wz_ads.css');

                    $ad_code = '
                    <div class="zxm_wzad-box">
                        <!-- 光影效果容器 -->
                        <div class="light-effect"></div>
                        <!-- 嵌入式标签 -->
                        <div style="
                            position: absolute;
                            top: -15px;
                            left: 12px;
                            height:30px;
                            background: #FFA500;
                            padding: 2px 6px;
                            font-size: 1.2em;
                            color: #667eea;
                            font-weight: bold;
                            display: flex;
                            align-items: center;
                            gap: 4px;
                            z-index: 2;
                            border-radius: 4px;
                        ">
                            <svg style="width:20px;height:20px;" viewBox="0 0 24 24" fill="#e161f9">
                                <path d="M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm-1 17.93c-3.95-.49-7-3.85-7-7.93 0-.62.08-1.21.21-1.79L9 15v1c0 1.1.9 2 2 2v1.93zm6.9-2.54c-.26-.81-1-1.39-1.9-1.39h-1v-3c0-.55-.45-1-1-1H8v-2h2c.55 0 1-.45 1-1V7h2c1.1 0 2-.9 2-2v-.41c2.93 1.19 5 4.06 5 7.41 0 2.08-.8 3.97-2.1 5.39z"/>
                            </svg>
                            <span>特别推荐</span>
                        </div>
    
                        <!-- 图片区域 -->
                        <div style="
                            position: relative;
                            width: 33.33%;
                            aspect-ratio: 1 / 1;
                            background-image: url(\''.$random_wzad['zwzimg'].'\');
                            background-size: contain;
                            background-repeat: no-repeat;
                            background-position: center;
                            flex-shrink: 0;
                            z-index: 2;
                            align-self: center; /* 垂直居中 */
                            margin: 8px; /* 增加边距 */
                        "></div>
    
                        <div class="zxm_wzad_text-container">' . $random_wztu . '</div>
                    </div>';
    
                    $paragraphs = preg_split('/(<p.*?>)/i', $content, -1, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY);
                    $total_paragraphs = floor(count($paragraphs) / 2);
                    
                    if ($total_paragraphs >= 2) {
                        // 段落数大于等于 2 则随机插入
                        $insert_index = 2 * wp_rand(2, $total_paragraphs - 1);
                        array_splice($paragraphs, $insert_index, 0, $ad_code);
                    } elseif ($total_paragraphs == 1) {
                        // 只有一个段落，插入到文章末尾
                        $paragraphs[] = $ad_code;
                    }
                    $content = implode('', $paragraphs);

                }
                return $content;
            } else {
                    return $content;
            }
        }
    }
    return $content;  // 必须的防御性返回
}
//文章页插入广告结束 zuoxm

二、CSS样式部分（我单独放在CSS文件中了，上传到服务器上即可）

功能代码中wp_enqueue_style(‘zxm_random_ad’, get_stylesheet_directory_uri() . ‘/zxm_wz_ads.css’);

假设css文件和func.php文件在相同目录下，如果你放在其它位置则记得修改此处路径

.zxm_wzad-box {
    position: relative;
    background: #ffffff;
    border-radius: 6px;
    padding: 16px; /* 增加内边距 */
    margin: 8px 0;
    min-height: 150px; /* 增加最小高度 */
    display: flex;
    align-items: center; /* 垂直居中 */
    overflow: visible;
}

.zxm_wzad-box .light-effect {
    position: absolute;
    top: 0;
    left: 0;
    width: 100%;
    height: 100%;
    border-radius: 6px;
    overflow: hidden; /* 确保光影效果不会溢出 */
}

.zxm_wzad-box .light-effect::before {
    content: "";
    position: absolute;
    top: -50%;
    left: -50%;
    width: 200%;
    height: 200%;
    background: linear-gradient(0deg, transparent, #667eea, transparent);
    animation: marqueeLight 3s linear infinite;
}

.zxm_wzad-box::after {
    content: "";
    position: absolute;
    top: 2px;
    right: 2px;
    bottom: 2px;
    left: 2px;
    background: white;
    border-radius: 4px;
    z-index: 1; /* 确保覆盖层在光影之上，内容之下 */
}

@keyframes marqueeLight {
    0% {
        transform: rotate(0deg);
    }
    100% {
        transform: rotate(360deg);
    }
}

.zxm_wzad_text-container {
    all: initial;
    width: 66.67%;
    font-size: 1em;
    line-height: 1.4;
    padding: 8px;
    color: #555;
    word-break: break-word;
    overflow-wrap: break-word;
    white-space: pre-wrap;
    display: block;
    z-index: 2;
    text-align: left;
    text-indent: 0 !important;  /* 修复首行偏移 */
}