WordPress අදහස් අංශයේ කෙටි කේත විග්‍රහ නොකිරීමට හේතු සහ විසඳුම්

在 වර්ඩ්ප්රෙස් ලිපියේ අදහස් දැක්වීමේ කොටසට ඇතුළු වන්න [shortcode]කෙසේ වෙතත්, ප්‍රතිඵලය අපේක්ෂිත බලපෑම වෙනුවට සරල පෙළ පමණක් පෙන්වයිද? මෙය ඇත්ත වශයෙන්ම WordPress හි පෙරනිමි යාන්ත්‍රණයයි. පහතින්, මම හේතු ක්‍රමානුකූලව විශ්ලේෂණය කර සම්පූර්ණ විසඳුමක් ලබා දෙන්නෙමි.

අදහස් දැක්වීමේ කොටස කෙටි කේත සඳහා සහය නොදක්වන්නේ ඇයි?

• පෙරනිමි සීමා කිරීම්
  ආරක්ෂක හේතූන් මත, WordPress අදහස් කොටසේ ස්වයංක්‍රීයව ක්‍රියාත්මක නොවේ. do_shortcode()මෙය පරිශීලකයින් විසින් අත්තනෝමතික ලෙස පෝරම, ස්ක්‍රිප්ට් හෝ අඩවි ආරක්ෂාවට බලපාන වෙනත් අන්තර්ගතයන් ඇතුළත් කිරීමෙන් වළක්වයි.

• සීමිත යෙදුම් විෂය පථය
  කෙටි යෙදුම ප්‍රධාන වශයෙන් ලිපි අන්තර්ගතයේ භාවිතය සඳහා නිර්මාණය කර ඇත (the_contentමෙයට උපකරණ හෝ විශේෂිත ප්ලගීන ඇතුළත් වන අතර, අදහස් දැක්වීමේ කොටස පෙරනිමියෙන් සහාය නොදක්වයි.

• ස්වයංක්‍රීය ආකෘතිකරණ බාධාව
  අදහස් පෙළ වනුයේ wpautop ස්වයංක්‍රීයව එකතු කරන්න <p> 和 <br> කෙටි කේතවල වාක්‍ය ඛණ්ඩ ව්‍යුහය බිඳ දැමිය හැකි ටැග්, ඒවා විග්‍රහ කළ නොහැකි බවට පත් කරයි.

අදහස් සඳහා කෙටි කේත සහාය සක්‍රීය කරන්නේ කෙසේද?

• අදහස් කෙටි කේත සක්‍රීය කරන්න
  මාතෘකාව මත functions.php ඔබගේ ගොනුවට හෝ කේත ස්නිපෙට් ප්ලගිනයට පහත කේතය එක් කරන්න:

  add_filter('comment_text', 'do_shortcode');
  

  මෙය අදහස් අංශය කෙටි කේත භාවිතා කිරීමට හේතු වේ.

• ප්ලගිනය සක්‍රිය කර ඇත්දැයි පරීක්ෂා කරන්න.
  බොහෝ කෙටි කේත ප්ලගීන වලින් පැමිණේ (සම්බන්ධතා පෝරමය 7 සහ WooCommerce වැනි). ප්ලගිනය සක්‍රීය කර නොමැති නම්, කෙටි කේත ක්‍රියා නොකරනු ඇත.

• වාක්‍ය ඛණ්ඩ දෝෂ මඟහරවා ගන්න
  කෙටි යෙදුම නිවැරදිව ලියා ඇති බව තහවුරු කරන්න, උදාහරණයක් ලෙස:

  [shortcode attribute="value"]内容[/shortcode]
  

• තේමා හෝ ප්ලගින ගැටුම් සඳහා පරීක්ෂා කරන්න
  කෙටි කේතය අක්‍රිය වීමට හේතු වන ගැටුම් තිබේදැයි පරීක්ෂා කර තහවුරු කිරීමට පෙරනිමි තේමාවට (Twenty Twenty-Five වැනි) මාරු වන්න, එක් එක් ප්ලගිනය එකින් එක අක්‍රීය කරන්න.

• හිස් හැඹිලිය
  හැඹිලි ප්ලගීන හෝ CDN භාවිතා කරන විට, බලපෑම දැකීමට නිවැරදි කිරීමෙන් පසු ඔබ හැඹිලිය හිස් කළ යුතුය.

අදහස් දැක්වීමේ අංශ කෙටි කේත ආරක්ෂිතව සක්‍රීය කිරීමට කේතය

ආරක්ෂක අවදානම් වළක්වා ගැනීම සඳහා, එය කළ හැක්කේ functions.php පහත සම්පූර්ණ උදාහරණය එක් කරන්න:

<?php
// 在评论区启用简码解析
add_filter('comment_text', 'do_shortcode');

// 限制允许的简码列表
function safe_comment_shortcodes($content) {
    // 定义允许的简码（加入 su_posts）
    $allowed_shortcodes = array('gallery', 'audio', 'video', 'contact-form-7', 'su_posts');

    // 遍历评论内容中的简码
    return preg_replace_callback('/\[(\w+)([^\]]*)\]/', function($matches) use ($allowed_shortcodes) {
        $shortcode = $matches[1];
        // 如果简码在允许列表中，正常解析
        if (in_array($shortcode, $allowed_shortcodes)) {
            return do_shortcode($matches[0]);
        }
        // 否则直接输出原始文本，避免执行
        return esc_html($matches[0]);
    }, $content);
}
add_filter('comment_text', 'safe_comment_shortcodes', 9);

කේත විස්තරය

• කෙටි කේත සක්‍රීය කරන්නපළමු පේළිය add_filter('comment_text', 'do_shortcode'); අදහස් දැක්වීමේ කොටසේ කෙටි කේත සහාය සක්‍රීය කරන්න.
• සීමා කළ කෙටි කේත:පාස් $allowed_shortcodes අරා අර්ථ දැක්වීම් කෙටි යෙදුම් වලට ඉඩ දෙයි, උදාහරණයක් ලෙස gallery,audio,video,contact-form-7,su_posts.
• ආරක්ෂිත හැසිරවීමපරිශීලකයා අවසර ලත් ලැයිස්තුවේ නොමැති කෙටි කේතයක් ඇතුළත් කළහොත්, අනතුරුදායක කෙටි කේත ක්‍රියාත්මක කිරීම වළක්වා ගැනීම සඳහා කේතය ස්වයංක්‍රීයව සරල පෙළට ගැලවී යනු ඇත.

හොඳම පිළිවෙත්

• අවශ්‍ය කෙටි කේත පමණක් ඉඩ දෙන්න.උදාහරණයක් ලෙස, මාධ්‍ය ඉදිරිපත් කිරීම් හෝ ආකෘති වලදී, බොහෝ කෙටි කේත භාවිතා කිරීමෙන් වළකින්න.
• ප්ලගින යාවත්කාලීන කිරීම් සඳහා නිතිපතා පරීක්ෂා කරන්නකෙටි කේත මූලාශ්‍ර ප්ලගිනය ආරක්ෂිත සහ විශ්වාසදායක බව සහතික කර ගන්න.
• හැඹිලිගත කිරීම සහ ආරක්ෂණ ප්ලගීන ඒකාබද්ධ කිරීමකෙටි කේත විදැහුම්කරණය නිසා ඇතිවන කාර්ය සාධන පීඩනය වළක්වා ගැනීමට.

ගතිකව වැඩිදියුණු කළ අනුවාදය: පසුපෙළ සැකසුම් අතුරුමුහුණත (සෙවීම + සමූහගත කිරීම + ඉදිරිපස ඉඟි)

ඔබට වඩාත් නම්‍යශීලී බවක් අවශ්‍ය නම්, ඔබට පහත වැඩිදියුණු කළ කේතය භාවිතා කළ හැකිය:

• සියලුම ලියාපදිංචි කෙටි කේත ස්වයංක්‍රීයව ලැයිස්තුගත කරන්න(ප්ලගීන මගින් සපයන ලද ඒවා ඇතුළුව).
• අභිරුචි කෙටි කේත ඇතුළත් කිරීමට සහය දක්වයි(මෙන් ）
• සෙවුම් කොටුව: වේගවත්ස්ථානගත කිරීමකෙටි යෙදුම.
• සමූහගත සංදර්ශකයප්ලගීන මූලාශ්‍රය අනුව කාණ්ඩගත කිරීම එය වඩාත් බුද්ධිමත් කරයි.
• භූමිකා අවසරපරිපාලක අදහස්වල කෙටි කේත පමණක් විග්‍රහ කරනු ලැබේ; සාමාන්‍ය පරිශීලක අදහස්වල කෙටි කේත "මෙම කෙටි කේතය පරිපාලකයින්ට පමණක් ලබා ගත හැකිය" යන පණිවිඩය පෙන්වනු ඇත.

<?php
// 添加后台菜单
function cwl_shortcode_settings_menu() {
    add_options_page(
        '评论简码设置',
        '评论简码设置',
        'manage_options',
        'cwl-shortcode-settings',
        'cwl_shortcode_settings_page'
    );
}
add_action('admin_menu', 'cwl_shortcode_settings_menu');

// 注册设置
function cwl_register_shortcode_settings() {
    register_setting('cwl_shortcode_settings_group', 'cwl_allowed_shortcodes');
    register_setting('cwl_shortcode_settings_group', 'cwl_custom_shortcodes');
}
add_action('admin_init', 'cwl_register_shortcode_settings');

// 设置页面内容
function cwl_shortcode_settings_page() {
    global $shortcode_tags;
    $allowed = get_option('cwl_allowed_shortcodes', array());
    $custom  = get_option('cwl_custom_shortcodes', array());

    ?>
    <div class="wrap">
        <h1>评论区简码设置</h1>
        <form method="post" action="options.php">
            <?php settings_fields('cwl_shortcode_settings_group'); ?>

            <h2>搜索简码</h2>
            <input type="text" id="cwl_shortcode_search" placeholder="输入简码关键字..." style="width:300px;">

            <h2>已注册简码（按插件来源分组）</h2>
            <p>勾选允许在评论区执行的简码：</p>
            <div id="cwl_shortcode_list">
                <?php
                // 按插件来源分组
                $groups = array();
                foreach ($shortcode_tags as $tag => $callback) {
                    $source = is_array($callback) ? get_class($callback[0]) : (is_object($callback) ? get_class($callback) : '主题/未知来源');
                    $groups[$source][] = $tag;
                }

                foreach ($groups as $source => $tags) {
                    echo "<h3>" . esc_html($source) . "</h3>";
                    foreach ($tags as $tag) {
                        ?>
                        <label class="cwl_shortcode_item">
                            <input type="checkbox" name="cwl_allowed_shortcodes[]" value="<?php echo esc_attr($tag); ?>" <?php checked(in_array($tag, $allowed)); ?>>
                            <?php echo esc_html($tag); ?>
                        </label><br>
                        <?php
                    }
                }
                ?>
            </div>

            <h2>自定义简码</h2>
            <p>输入额外允许的简码（用逗号分隔）：</p>
            <textarea name="cwl_custom_shortcodes" rows="3" cols="50"><?php echo esc_textarea(implode(',', (array)$custom)); ?></textarea>

            <?php submit_button(); ?>
        </form>
    </div>

    <script>
    // 简码搜索功能
    document.getElementById('cwl_shortcode_search').addEventListener('keyup', function() {
        var keyword = this.value.toLowerCase();
        document.querySelectorAll('.cwl_shortcode_item').forEach(function(item) {
            var text = item.textContent.toLowerCase();
            item.style.display = text.indexOf(keyword) > -1 ? '' : 'none';
        });
    });
    </script>
    <?php
}

// 评论区简码过滤（结合角色权限 + 前端提示）
function cwl_safe_comment_shortcodes($content) {
    $allowed_shortcodes = get_option('cwl_allowed_shortcodes', array());
    $custom_shortcodes  = get_option('cwl_custom_shortcodes', array());
    $allowed_shortcodes = array_merge($allowed_shortcodes, (array)$custom_shortcodes);

    return preg_replace_callback('/\[(\w+)([^\]]*)\]/', function($matches) use ($allowed_shortcodes) {
        $shortcode = $matches[1];
        // 管理员可解析简码
        if (current_user_can('manage_options')) {
            if (in_array($shortcode, $allowed_shortcodes)) {
                return do_shortcode($matches[0]);
            }
            return esc_html($matches[0]);
        } else {
            // 普通用户提示信息
            if (in_array($shortcode, $allowed_shortcodes)) {
                return '<span style="color:red;">此简码仅管理员可用</span>';
            }
            return esc_html($matches[0]);
        }
    }, $content);
}
add_filter('comment_text', 'cwl_safe_comment_shortcodes', 9);

总结

ආරක්ෂක සහ කාර්ය සාධන හේතූන් මත WordPress අදහස් කොටස් පෙරනිමියෙන් කෙටිකතාව විග්‍රහ නොකරයි. ඒ වෙනුවට ඔබට [විග්‍රහ කිරීමේ මෙවලම] භාවිතා කළ හැකිය. functions.php කෙටි කේත සක්‍රීය කිරීමට පෙරහනක් එකතු කර එය ආරක්ෂාව සමඟ ඒකාබද්ධ කරන්න.