Enrico Sorcinelli

The <a href="https://wordpress.org/plugins/semrush-seo-writing-assistant/" rel="ugc">SEMrush SEO Writing Assistant</a> plugin read only from post <code>title</code> and post <code>content</code> 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.
<h3>Usage</h3>
Once the plugin is activated you can configure it by defining following constants in your wp-config.php:
<ul>
<li><code>SWA_SEMRUSH_CUSTOM_FIELDS_PLUGIN_AUTOENABLE</code></li>
</ul>
Automatically enable use of additional text value for SEMrush check. The default value is <code>false</code>. 
This is the only configuration you have to do in order to have the plugin feature working. 
For example:
<pre><code>define( 'SWA_SEMRUSH_CUSTOM_FIELDS_PLUGIN_AUTOENABLE', true );
</code></pre>
<ul>
<li><code>SWA_SEMRUSH_CUSTOM_FIELDS_PLUGIN_INTERVAL</code></li>
</ul>
Allows to change the interval between automatic updates of the text used by SEMrush checks. 
The default value is <code>5</code> seconds.For example:
<pre><code>define( 'SWA_SEMRUSH_CUSTOM_FIELDS_PLUGIN_INTERVAL', 10 );
</code></pre>
You can alernatavely control the plugins programmatically, by using 
 semrush_seo_writing_assistant_post_types (optional) filter and <code>SeoWritingAssistantSEMrushCustomFields</code> JavaScript object (see below).
<h3>API</h3>
<h4>WordPress Hooks</h4>
**<code>swa_semrush_custom_fields_settings</code> **
Filters plugin settings values.
<pre><code>apply_filters( 'swa_semrush_custom_fields_settings', array $settings )
</code></pre>
<code>semrush_seo_writing_assistant_post_types</code>
Filters post types where to enable plugin. Default to <code>array( 'post', 'page', 'product' )</code>.
<pre><code>apply_filters( 'semrush_seo_writing_assistant_post_types', array $post_types )
</code></pre>
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.
<h4>JavaScript Event</h4>
<code>seo-writing-assistant-semrush</code>
This event allows you to update the text for SEMrush analysis. 
The following example will update text for SEMrush check every 5 seconds, using <code>excerpt</code> and <code>my_custom_fields</code> custom field values (working both with block and classic editors):
<pre><code>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();
 } )
} );
</code></pre>
Note that if you have previously defined constant <code>SWA_SEMRUSH_CUSTOM_FIELDS_PLUGIN_AUTOENABLE</code> to <code>true</code>, 
you don’t have to create new <code>SeoWritingAssistantSEMrushCustomFields</code> object.
<h4>JavaScript API</h4>
<code>setHtml()</code>
The following example will update programmatically the text used by SEMrush check with an arbitrary value:
<pre><code>jQuery( document ).ready( function() {
 var swa = new SeoWritingAssistantSEMrushCustomFields( { interval: 0 } );
 swa.setHtml( 'foo baz bar' );
} );
</code></pre>
<h4>Advanced Custom Fields</h4>
The plugin checks if Advanced Custom Fields is active in your WordPress instance and adds a custom setting to each field 
(only for <code>input</code> within text, radio and checkbox type, <code>textarea</code> and <code>select</code> elements) allowing you to add his value 
to SEMrush check without having to write any additional JavaScript code.
<h4>Autodiscovery</h4>
The plugin also automatically add to text used by SEMrush checks, the values of all HTML elements 
with <code>swa-scf</code> class or <code>data-swa-scf</code> attribute. 
This will applied only for <code>input</code> (within text, radio and checkbox type), <code>textarea</code>, and <code>select</code> elements.

SEO Writing Assistant SEMrush Custom Fields

The SEMrush SEO Writing Assistant plugin read only from post title and post content elements for the real time check.

SEMrush CY LTD

For your content to be successful, it needs to be visible and engaging. SEO Writing Assistant—our smart editor tool—ensures that your text ticks both of these boxes by providing recommendations and improvements in real time.
The tool integrates seamlessly with WordPress and offers key readability and SEO suggestions based on the best-performing content in Google’s SERPs. Whether you’re writing your own copy or editing someone else’s, SEO Writing Assistant makes the end product as impactful and effective as possible—for readers and search engines.
<h3>Key Features</h3>
<ul>
<li>Readability: Use the Flesch-Kincaid score to assess and improve your text’s readability</li>
<li>Recommended Keywords: Receive semantically related keyword suggestions that can help boost your visibility</li>
<li>Tone of Voice: Ensure that your tone is smooth and consistent across your text</li>
<li>Plagiarism Check: Verify that your writer has submitted original content and avoid penalization</li>
<li>Rephraser: Rework pieces of text to improve quality, target different channels, or overcome writer’s block</li>
<li>Overall Score: Evaluate and maximize the SEO potential of your text based on key on-page factors</li>
</ul>
<h3>How Does It Work?</h3>
The SEO Writing Assistant plugin allows you to write, assess, and edit your content in WordPress.
To set it up, follow these steps:
<ol>
<li>Click “Download” at the top of this page. The plugin will automatically save as a .zip file.</li>
<li>Log in to the admin area of your WordPress account.</li>
<li>Find “Plugins” in the main menu, and click on “Add New”.</li>
<li>Find and click “Upload Plugin” at the top of the page and select the .zip file.</li>
</ol>
Once the plugin has been installed, it should be activated in your “Installed Plugins” list (if it isn’t, ensure that you do so). Go to the page or post you want to optimize and click on “Connect SEO Content Template” (you will need to be logged in to your Semrush account).
<h3>Limits</h3>
To use SEO Writing Assistant, you need to first specify your target keywords. This requires a Semrush account.
With a Free or Pro Semrush account, you can create one recommendation set (tied to a document) for a lifetime. Higher tier accounts have different keyword budgets depending on the subscription plan, as well as full access to the powerful Semrush Content Marketing Platform.
<h3>Technical details</h3>
Please be aware that the plugin uses a third-party code provided by the <a href="https://www.semrush.com/swa/" rel="nofollow ugc">Semrush SEO Writing Assistant</a> tool that is not reviewed by the WordPress team. To analyze your text, the plugin will send it to Semrush API where texts can also be stored for statistical analysis. To improve user experience, telemetry data is collected by Google Analytics.
See also
<a href="https://www.semrush.com/company/legal/privacy-policy/" rel="nofollow ugc">Semrush Privacy Policy</a> 
<a href="https://www.semrush.com/company/legal/terms-of-use/" rel="nofollow ugc">Semrush Terms and Conditions</a>

Semrush SEO Writing Assistant

The Semrush SEO Writing Assistant provides instant recommendations for content optimization based on the best-performing articles in Google's top 10.

SEO Writing Assistant SEMrush Custom Fields vs Semrush SEO Writing Assistant