[WordPress] 外掛分享： SEO Writing Assistant SEMrush Custom Fields

內容簡介

這款 SEMrush SEO Writing Assistant 插件只從文章的 title 和 content 元素中讀取內容進行即時檢查。

這個輕量級的插件允許你在檢查時使用任意值，除了這些值之外。

因此，如果您使用某種頁面構建器、字段管理器等工具，您只需要在您的 wp_config.php 文件中定義一個常數，並最好寫一點 JavaScript 代碼以指定哪些字段。

請注意，本插件不會取代 SEMrush SEO Writing Assistant，而是旨在一起使用。

用法

啟用插件後，您可以在 wp-config.php 中定義以下常數來配置它:

SWA_SEMRUSH_CUSTOM_FIELDS_PLUGIN_AUTOENABLE

自動啟用 SEMrush 檢查的附加文本值使用。預設值為 false。
這是您必須進行的唯一配置，以使插件功能正常運作。
例如:

define( 'SWA_SEMRUSH_CUSTOM_FIELDS_PLUGIN_AUTOENABLE', true );

SWA_SEMRUSH_CUSTOM_FIELDS_PLUGIN_INTERVAL

允許更改 SEMrush 檢查使用的文本自動更新之間的間隔。
默認值為 5 秒。例如:

define( 'SWA_SEMRUSH_CUSTOM_FIELDS_PLUGIN_INTERVAL', 10 );

您還可以使用 semrush_seo_writing_assistant_post_types（可選）過濾器和 SeoWritingAssistantSEMrushCustomFields JavaScript 對象進行插件的編程控制（見下文）。

API
WordPress Hooks

**swa_semrush_custom_fields_settings **

過濾插件設置值。

apply_filters( 'swa_semrush_custom_fields_settings', array $settings )

semrush_seo_writing_assistant_post_types

過濾要啟用插件的文章類型。預設為 array( 'post', 'page', 'product' )。

apply_filters( 'semrush_seo_writing_assistant_post_types', array $post_types )

該過濾器與 SEMrush SEO Writing Assistant 插件（自版本 1.0.4 起使用）使用相同的名稱，用於相同的目的。

JavaScript Event

seo-writing-assistant-semrush

此事件可允許您更新 SEMrush 分析所用的文本。
以下示例將使用 excerpt 和 my_custom_fields 自定義字段值（可以在块和傳統編輯器中使用）每 5 秒為 SEMrush 檢查更新一次文本:

jQuery( document ).ready( function() {
var swa = new SeoWritingAssistantSEMrushCustomFields( { interval: 5 } );
jQuery( document ).on( 'seo-writing-assistant-semrush', function( event, data ) {
data.html += jQuery( '#excerpt' ).val() + "\n"
+ jQuery( '.editor-post-excerpt__textarea textarea').val() + "\n"
+ jQuery( '#my_custom_fields' ).val();
} )
} );

請注意，如果您先前已將常數 SWA_SEMRUSH_CUSTOM_FIELDS_PLUGIN_AUTOENABLE 定義為 true，
則不必創建新的 SeoWritingAssistantSEMrushCustomFields 對象。

JavaScript API

setHtml()

以下示例將使用任意值對 SEMrush 檢查使用的文本進行程序化更新:

jQuery( document ).ready( function() {
var swa = new SeoWr

外掛標籤

開發者團隊

📦 歷史版本下載

1.0.31.1.0trunk

原文外掛簡介

The SEMrush SEO Writing Assistant plugin read only from post title and post content elements for the real time check.
This lightweight plugin allows you to use an arbitrary value for that check in addition to those values.
So, if you are using some kind of a page builders, field managers and so on, you have only to define a constant in your wp_config.php file and eventually to write a little bit of JavaScript code in order to specify which fields.
Note that the plugin don’t replace SEMrush SEO Writing Assistant but is intended to be used together.
Usage
Once the plugin is activated you can configure it by defining following constants in your wp-config.php:

SWA_SEMRUSH_CUSTOM_FIELDS_PLUGIN_AUTOENABLE

Automatically enable use of additional text value for SEMrush check. The default value is false.
This is the only configuration you have to do in order to have the plugin feature working.
For example:
define( 'SWA_SEMRUSH_CUSTOM_FIELDS_PLUGIN_AUTOENABLE', true );

SWA_SEMRUSH_CUSTOM_FIELDS_PLUGIN_INTERVAL

Allows to change the interval between automatic updates of the text used by SEMrush checks.
The default value is 5 seconds.For example:
define( 'SWA_SEMRUSH_CUSTOM_FIELDS_PLUGIN_INTERVAL', 10 );

You can alernatavely control the plugins programmatically, by using
semrush_seo_writing_assistant_post_types (optional) filter and SeoWritingAssistantSEMrushCustomFields JavaScript object (see below).
API
WordPress Hooks
**swa_semrush_custom_fields_settings **
Filters plugin settings values.
apply_filters( 'swa_semrush_custom_fields_settings', array $settings )

semrush_seo_writing_assistant_post_types
Filters post types where to enable plugin. Default to array( 'post', 'page', 'product' ).
apply_filters( 'semrush_seo_writing_assistant_post_types', array $post_types )

The filter has the same name as the one used by SEMrush SEO Writing Assistant plugin (since version 1.0.4) used for the same purpose.
JavaScript Event
seo-writing-assistant-semrush
This event allows you to update the text for SEMrush analysis.
The following example will update text for SEMrush check every 5 seconds, using excerpt and my_custom_fields custom field values (working both with block and classic editors):
jQuery( document ).ready( function() {
var swa = new SeoWritingAssistantSEMrushCustomFields( { interval: 5 } );
jQuery( document ).on( 'seo-writing-assistant-semrush', function( event, data ) {
data.html += jQuery( '#excerpt' ).val() + "\n"
+ jQuery( '.editor-post-excerpt__textarea textarea').val() + "\n"
+ jQuery( '#my_custom_fields' ).val();
} )
} );

Note that if you have previously defined constant SWA_SEMRUSH_CUSTOM_FIELDS_PLUGIN_AUTOENABLE to true,
you don’t have to create new SeoWritingAssistantSEMrushCustomFields object.
JavaScript API
setHtml()
The following example will update programmatically the text used by SEMrush check with an arbitrary value:
jQuery( document ).ready( function() {
var swa = new SeoWritingAssistantSEMrushCustomFields( { interval: 0 } );
swa.setHtml( 'foo baz bar' );
} );

Advanced Custom Fields
The plugin checks if Advanced Custom Fields is active in your WordPress instance and adds a custom setting to each field
(only for input within text, radio and checkbox type, textarea and select elements) allowing you to add his value
to SEMrush check without having to write any additional JavaScript code.
Autodiscovery
The plugin also automatically add to text used by SEMrush checks, the values of all HTML elements
with swa-scf class or data-swa-scf attribute.
This will applied only for input (within text, radio and checkbox type), textarea, and select elements.

延伸相關外掛