From c18b2b2371cd68f34e358997d273b69ab032af5d Mon Sep 17 00:00:00 2001
From: Tim Hughes <timbocode@gmail.com>
Date: Mon, 18 May 2020 20:22:41 +0100
Subject: [PATCH] Improvements to help pages

---
 assets/admin/css/common.css                   |   4 +-
 includes/admin/views/help-manager.php         |   4 -
 includes/admin/views/help/developers.php      |  49 +++-
 includes/admin/views/help/getting-started.php |  11 +-
 includes/admin/views/help/local-seo.php       |   6 +-
 includes/admin/views/help/variables.php       | 228 ------------------
 includes/modules/404-monitor/views/help.php   |  22 +-
 includes/modules/redirections/views/help.php  |  20 +-
 includes/modules/sitemap/views/help.php       |  24 +-
 9 files changed, 107 insertions(+), 261 deletions(-)
 delete mode 100644 includes/admin/views/help/variables.php

diff --git a/assets/admin/css/common.css b/assets/admin/css/common.css
index cb60dd5..77adccb 100644
--- a/assets/admin/css/common.css
+++ b/assets/admin/css/common.css
@@ -11,7 +11,7 @@
 .cpseo-wrap h2{font-size:2.7em;font-weight:300;line-height:1.3;margin:40px 0 .6em;text-align:center}
 .cpseo-wrap .page-title{font-size:2em;font-weight:400;line-height:1;margin:35px 0 20px}
 .cpseo-wrap h3{font-size:1.2em;line-height:1.5;margin:1.2em 0 .6em;color:#057f99}
-.cpseo-wrap h4{color:#23282d}
+.cpseo-wrap h4{color:#057f99}
 .cpseo-wrap ol li p{font-size:14px;font-weight:400}
 .cpseo-wrap .cpseo-text{font-size:19px;font-weight:400;line-height:1.6em;min-height:40px;margin:1em 200px 1em 0;margin-top:1.4em;color:#555d66}
 .cpseo-wrap .nav-tab{font-size:18px;padding-right:15px;padding-left:15px}
@@ -46,6 +46,8 @@
 .cpseo-tabs-navigation:not(.cpseo-custom){float:left;width:200px;margin-right:-1px}
 .cpseo-tabs-navigation:not(.cpseo-custom) a{font-size:16px;display:block;box-sizing:border-box;padding:11px 15px;text-decoration:none;color:#6c6c6c;border:solid #e5e5e5;border-width:0 1px 1px;outline:none;background:#f6f6f6;box-shadow:none}
 .cpseo-tabs-navigation:not(.cpseo-custom) a .dashicons,.cpseo-tabs-navigation:not(.cpseo-custom) a .fa,.cpseo-tabs-navigation:not(.cpseo-custom) a .image-icon{font-size:18px;min-width:20px;margin-right:10px;text-align:center;color:#6c6c6c}
+.cpseo-tabs-navigation:not(.cpseo-custom) a [class*=" dashicons-visual-"], .cpseo-tabs-navigation:not(.cpseo-custom) a [class*=" dashicons-visual-"] {opacity:1;filter: brightness(0.4);}
+.cpseo-tabs-navigation:not(.cpseo-custom) a:hover [class*=" dashicons-visual-"], .cpseo-tabs-navigation:not(.cpseo-custom) a:hover  [class*=" dashicons-visual-"] {opacity:1;filter: brightness(1);}
 .cpseo-tabs-navigation:not(.cpseo-custom) a .image-icon img {width:20px;height:20px;max-width:20px;max-height:20px;}
 .cpseo-tabs-navigation:not(.cpseo-custom) a.active,.cpseo-tabs-navigation:not(.cpseo-custom) a:focus,.cpseo-tabs-navigation:not(.cpseo-custom) a:hover{color:#fff;background:#361946}
 .cpseo-tabs-navigation:not(.cpseo-custom) a.active .dashicons,.cpseo-tabs-navigation:not(.cpseo-custom) a.active .fa,.cpseo-tabs-navigation:not(.cpseo-custom) a:focus .dashicons,.cpseo-tabs-navigation:not(.cpseo-custom) a:focus .fa,.cpseo-tabs-navigation:not(.cpseo-custom) a:hover .dashicons,.cpseo-tabs-navigation:not(.cpseo-custom) a:hover .fa{color:#fff}
diff --git a/includes/admin/views/help-manager.php b/includes/admin/views/help-manager.php
index 1b9fbbc..2d793d3 100644
--- a/includes/admin/views/help-manager.php
+++ b/includes/admin/views/help-manager.php
@@ -20,10 +20,6 @@
 		'title' => esc_html__( 'Local SEO', 'cpseo' ),
 		'view'  => 'help/local-seo.php',
 	),
-	'variables'       => array(
-		'title' => esc_html__( 'Variables', 'cpseo' ),
-		'view'  => 'help/variables.php',
-	),
 	'developers'       => array(
 		'title' => esc_html__( 'Developers', 'cpseo' ),
 		'view'  => 'help/developers.php',
diff --git a/includes/admin/views/help/developers.php b/includes/admin/views/help/developers.php
index a4dd596..9628939 100644
--- a/includes/admin/views/help/developers.php
+++ b/includes/admin/views/help/developers.php
@@ -9,4 +9,51 @@
 
 ?>
 
-<h3><?php esc_html_e( 'Coming Soon', 'cpseo' ); ?></h3>
\ No newline at end of file
+<h3><?php esc_html_e( 'Filters and Hooks', 'cpseo' ); ?></h3>
+
+
+<p><?php esc_html_e( 'There are a number of hooks and filters in Classic SEO that developers can use to interact with data output by Classic SEO. Here\'s a few of them.', 'cpseo' ); ?></p>
+
+<h4><?php esc_html_e( 'Filter to show/hide SEO Metabox', 'cpseo' ); ?></h4>
+<p><?php esc_html_e( 'To hide the SEO metabox, return false.', 'cpseo' ); ?></p>
+<?php
+$code1 = 'add_filter( \'cpseo/metabox/add_seo_metabox\', function( $default ) {
+  return $default;
+});';
+?>
+<p><pre><code><?php esc_html_e($code1); ?></code></pre></p>
+
+<hr>
+
+<h4><?php esc_html_e( 'Filter to change the position of the SEO metabox', 'cpseo' ); ?></h4>
+<p><?php esc_html_e( 'Options for $priority are: \'low\', \'default\', \'core\', \'high\'.', 'cpseo' ); ?></p>
+<?php
+$code2 = 'add_filter( \'cpseo/metabox/priority\', function( $priority ) {
+  return $priority;
+});';
+?>
+<p><pre><code><?php esc_html_e($code2); ?></code></pre></p>
+
+<hr>
+
+<h4><?php esc_html_e( 'Filter to change taxonomy icons in the options panel', 'cpseo' ); ?></h4>
+<p><?php esc_html_e( 'This example sets the icon for the custom \'event_cat\' taxonomy to \'dashicons dashicons-category\'.', 'cpseo' ); ?></p>
+<?php
+$code3 = 'add_filter( \'cpseo/taxonomy_icons\', function( $icons ) {
+	$icons[\'event_cat\'] = \'dashicons dashicons-category\';
+	return $icons;
+});';
+?>
+<p><pre><code><?php esc_html_e($code3); ?></code></pre></p>
+
+<hr>
+
+<h4><?php esc_html_e( 'Filter to change taxonomy icons in the options panel', 'cpseo' ); ?></h4>
+<p><?php esc_html_e( 'This example sets the icon for the custom \'event\' post type to \'dashicons dashicons-calendar\'.', 'cpseo' ); ?></p>
+<?php
+$code4 = 'add_filter( \'cpseo/post_type_icons\', function( $icons ) {
+	$icons[\'event\'] = \'dashicons dashicons-calendar\';
+	return $icons;
+});';
+?>
+<p><pre><code><?php esc_html_e($code4); ?></code></pre></p>
diff --git a/includes/admin/views/help/getting-started.php b/includes/admin/views/help/getting-started.php
index 7010ec6..611bcd4 100644
--- a/includes/admin/views/help/getting-started.php
+++ b/includes/admin/views/help/getting-started.php
@@ -10,24 +10,24 @@
 ?>
 <h3><?php esc_html_e( 'Getting started with Classic SEO', 'cpseo' ); ?></h3>
 <p>
-	<?php esc_html_e( 'Classic SEO is a Search Engine Optimization plugin built specifically for ClassicPress. It is based on Rank Math but there some differences both in the way it works and "behind the scenes".', 'cpseo' ); ?>
+	<?php esc_html_e( 'Classic SEO is a Search Engine Optimization plugin built specifically for ClassicPress. It is based on Rank Math but there are some key differences both in the way it works and "behind the scenes".', 'cpseo' ); ?>
 </p>
 <p>
 	<?php esc_html_e( 'While Rank Math provides support for bbPress, BuddyPress and AMP, Classic SEO does not and probably never will. Likewise, it is unlikely that Classic SEO will ever feature the ability to edit .htaccess and robots.txt.', 'cpseo' ); ?>
 </p>
 <p>
-	<?php esc_html_e( 'Another difference is that Classic SEO does not have the SEO Analysis tool.', 'cpseo' ); ?>
+	<?php esc_html_e( 'A couple of other differences are that Classic SEO does not have the SEO Analysis tool and it does not support the Gutenberg block editor.', 'cpseo' ); ?>
 </p>
 <h3><?php esc_html_e( 'Found a bug?', 'cpseo' ); ?></h3>
 <p>
-	<?php esc_html_e( 'It should be noted that Classic SEO is still in the  early stages of development and bugs are likely.', 'cpseo' ); ?>
+	<?php esc_html_e( 'It should be noted that Classic SEO is still in the early stages of development and bugs are likely.', 'cpseo' ); ?>
 </p>
 <p>
 	<?php 
 	printf(
 		/* translators: 1: Link to ClassicPress Forums 2: Link to GitHub */
 		__('If you do find what looks like a bug, please either report it on the <a rel="nofollow noopener noreferrer" href="%1$s" target="_blank">ClassicPress forums</a> or <a rel="nofollow noopener noreferrer" href="%2$s" target="_blank">open an issue on GitHub</a>.', 'cpseo' ),
-		'https://forums.classicpress.net/tags/classic-seo', 'https://github.com/ClassicPress-research/classicpress-seo/issues'); ?>
+		'https://forums.classicpress.net/tags/classic-seo', 'https://github.com/ClassicPress-plugins/classicpress-seo/issues'); ?>
 </p>
 <h3><?php esc_html_e( 'Plans for future releases', 'cpseo' ); ?></h3>
 <p>
@@ -37,6 +37,9 @@
 		__('A key future addition to Classic SEO will be support for <a rel="nofollow noopener noreferrer" href="%1$s" target="_blank">Classic Commerce</a>.', 'cpseo' ),
 		'https://github.com/ClassicPress-research/classic-commerce'); ?>
 </p>
+<p>
+	<?php esc_html_e( 'It is also planned to improve support for the most popular page builders such as Beaver Builder, Divi and Elementor.', 'cpseo' ); ?>
+</p>
 <p>
 	<?php 
 	printf(
diff --git a/includes/admin/views/help/local-seo.php b/includes/admin/views/help/local-seo.php
index 9928ca1..fa41489 100644
--- a/includes/admin/views/help/local-seo.php
+++ b/includes/admin/views/help/local-seo.php
@@ -10,10 +10,10 @@
 ?>
 <h3><?php esc_html_e( 'Local SEO', 'cpseo' ); ?></h3>
 <p>
-	<?php esc_html_e( 'Local SEO is a way for you to rank better for searches made by your people in the area where you operate. It is the best way for you to get your products and services in front of the local customers.', 'cpseo' ); ?>
+	<?php esc_html_e( 'Local SEO is a way for you to rank better for searches made by people local to the area in which you operate. It is the best way for you to get your products and services in front of the local customers.', 'cpseo' ); ?>
 </p>
 <p>
-	<?php esc_html_e( 'There are various methods for optimizing your website for local SEO but the easiest method is built right inside the Classic SEO plugin.', 'cpseo' ); ?>
+	<?php esc_html_e( 'There are various methods for optimizing your website for local SEO but Classic SEO has many tools to help.', 'cpseo' ); ?>
 </p>
 
 <p>
@@ -23,7 +23,7 @@
 	<?php
 	printf(
 		/* translators: link to local seo settings */
-		__( 'Then, head over to <a href="%1$s">Classic SEO > Titles and Meta > Local SEO</a> and add more information about your Local Business like your Company Name, Logo, Email ID, Phone number, Address, And Contact/About pages.', 'cpseo' ),
+		__( 'Then, head over to <a href="%1$s">Classic SEO > Titles and Meta > Local SEO</a> and add more information about your Local Business like your Company Name, Logo, Email ID, Phone number, Address and Contact/About pages.', 'cpseo' ),
 		Helper::get_admin_url( 'options-titles#setting-panel-local' )
 	);
 	?>
diff --git a/includes/admin/views/help/variables.php b/includes/admin/views/help/variables.php
deleted file mode 100644
index f10bc32..0000000
--- a/includes/admin/views/help/variables.php
+++ /dev/null
@@ -1,228 +0,0 @@
-<?php
-/**
- * Local SEO tab.
- *
- * @package    Classic_SEO
- * @subpackage Classic_SEO\Admin\Help
- */
-
-use Classic_SEO\Helper;
-?>
-
-<div class="help_variables">
-	<table class="cpseo-help cpseo-table-scrollable">
-		<thead>
-			<tr>
-				<th scope="col"><?php esc_html_e( 'Variable', 'cpseo' ); ?></th>
-				<th scope="col" colspan="2"><?php esc_html_e( 'Description', 'cpseo' ); ?></th>
-			</tr>
-		</thead>
-		<tbody>
-			<tr>
-				<td><?php esc_html_e( '%sep%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Separator Character', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Separator character, as set in the Title Settings', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%search_query%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Search Query', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Search query (only available on search results page)', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%count(varname)%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Counter', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Starts at 1 and increments by 1.', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%filename%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'File Name', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'File Name of the attachment', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%sitename%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Site Title', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Title of the site', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%sitedesc%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Site Description', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Description of the site', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%currentdate%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Current Date', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Current server date', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%currentday%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Current Day', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Current server day', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%currentmonth%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Current Month', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Current server month', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%currentyear%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Current Year', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Current server year', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%currenttime%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Current Time', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Current server time', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%currenttime(F jS, Y)%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Current Time (advanced)', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Current server time with custom formatting pattern.', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%title%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Post Title', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Title of the current post/page', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%parent_title%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Post Title of parent page', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Title of the parent page of the current post/page', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%excerpt%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Post Excerpt', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Excerpt of the current post (or auto-generated if it does not exist)', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%excerpt_only%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Post Excerpt', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Excerpt of the current post (without auto-generation)', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%date%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Date Published', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Publication date of the current post/page <strong>OR</strong> specified date on date archives', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%modified%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Date Modified', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Last modification date of the current post/page', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%date(F jS, Y)%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Date Published (advanced)', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Publish date with custom formatting pattern.', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%modified(F jS, Y)%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Date Modified (advanced)', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Modified date with custom formatting pattern.', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%category%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Post Category', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'First category (alphabetically) associated to the current post <strong>OR</strong> current category on category archives', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%categories%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Post Categories', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Comma-separated list of categories associated to the current post', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%categories(limit=3&amp;separator= | &amp;exclude=12,23)%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Categories (advanced)', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Output list of categories associated to the current post, with customisation options.', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%tag%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Post Tag', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'First tag (alphabetically) associated to the current post <strong>OR</strong> current tag on tag archives', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%tags%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Post Tags', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Comma-separated list of tags associated to the current post', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%tags(limit=3&amp;separator= | &amp;exclude=12,23)%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Tags (advanced)', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Output list of tags associated to the current post, with customisation options.', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%term%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Current Term', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Current term name', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%term_description%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Term Description', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Current term description', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%customterm(taxonomy-name)%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Custom Term (advanced)', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Custom term value.', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%customterm_desc(taxonomy-name)%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Custom Term description', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Custom Term description.', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%userid%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Author ID', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Author\'s user id of the current post, page or author archive.', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%name%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Post Author', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Display author\'s nicename of the current post, page or author archive.', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%user_description%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Author Description', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Author\'s biographical info of the current post, page or author archive.', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%id%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Post ID', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'ID of the current post/page', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%focuskw%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Focus Keyword', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Focus Keyword of the current post', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%customfield(field-name)%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Custom Field (advanced)', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Custom field value.', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%page%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Page', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Page number with context (i.e. page 2 of 4). Only displayed on page 2 and above.', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%pagenumber%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Page Number', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Current page number', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%pagetotal%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Max Pages', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Max pages number', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%pt_single%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Post Type Name Singular', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Name of current post type (singular)', 'cpseo' ); ?></span></td>
-			</tr>
-			<tr>
-				<td><?php esc_html_e( '%pt_plural%', 'cpseo' ); ?></td>
-				<td><strong><?php esc_html_e( 'Post Type Name Plural', 'cpseo' ); ?></strong></td>
-				<td><span><?php esc_html_e( 'Name of current post type (plural)', 'cpseo' ); ?></span></td>
-			</tr>
-		</tbody>
-	</table>
-</div>
\ No newline at end of file
diff --git a/includes/modules/404-monitor/views/help.php b/includes/modules/404-monitor/views/help.php
index d8cff84..7dccf88 100644
--- a/includes/modules/404-monitor/views/help.php
+++ b/includes/modules/404-monitor/views/help.php
@@ -9,25 +9,33 @@
 ?>
 
 <h3><?php esc_html_e( '404 Monitor', 'cpseo' ); ?></h3>
-<p><?php esc_html_e( '404 errors happen when someone requests a page or file that doesn\'t exist - actually, it\'s more accurate to say the web server can\'t find the file.', 'cpseo' ); ?></p>
+<p><?php esc_html_e( '404 errors happen when someone requests a page or file that doesn\'t exist.', 'cpseo' ); ?></p>
 
 <h4><?php esc_html_e( '404s happen when:', 'cpseo' ); ?></h4>
 
 <ol>
 	<li><?php esc_html_e( 'Someone types the wrong address', 'cpseo' ); ?></li>
 	<li><?php esc_html_e( 'Someone links to the wrong address', 'cpseo' ); ?></li>
-	<li><?php esc_html_e( 'The file or page moves to a different address', 'cpseo' ); ?></li>
+	<li><?php esc_html_e( 'The file or page has moved to a different address', 'cpseo' ); ?></li>
 	<li><?php esc_html_e( 'The page or file is deleted', 'cpseo' ); ?></li>
 	<li><?php esc_html_e( 'The page or file never existed', 'cpseo' ); ?></li>
 </ol>
 
-<p><?php esc_html_e( 'They\'re actually very common on the web. And they\'re never a good thing.', 'cpseo' ); ?></p>
+<p><?php esc_html_e( '404 errors are the most common type of errors you\'ll see when browsing the web. In general, they won\'t hurt your ranking but too many 404 errors will provide a poor user experience, so they\'re generally best avoided.', 'cpseo' ); ?></p>
 
-<p><?php esc_html_e( 'If you visit a site, you probably want to read or view content on that site. You won\'t stay on the site if the content is missing. Serving 404 errors to your visitors is a good way to lose them.', 'cpseo' ); ?></p>
+<p><?php esc_html_e( 'If you visit a site, you probably want to read or view content on that site. You won\'t stay on the site if the content is missing. Serving many 404 errors to your visitors is a good way to lose them.', 'cpseo' ); ?></p>
 
-<p><?php esc_html_e( 'It doesn\'t matter if it\'s your fault, their fault, or someone else\'s. Maybe they clicked on a broken link caused by a typing mistake on another website. Maybe they cut-and-pasted a URL wrong. Or possibly they made a spelling mistake when they typed a URL manually.', 'cpseo' ); ?></p>
+<p><?php esc_html_e( 'It doesn\'t matter either who\'s to "blame" for the error. Maybe someone clicked on a broken link on another website. Or maybe they made a typo when they entered a URL in their browser.', 'cpseo' ); ?></p>
+
+<p><?php esc_html_e( 'But it could equally be caused if, for example, you changed the URL of an article to make it more appealing to search engines. Or perhaps you just deleted a page because it was no longer needed.', 'cpseo' ); ?></p>
+
+<h4><?php esc_html_e( 'What does the 404 Monitor do?', 'cpseo' ); ?></h4>
+
+<p><?php esc_html_e( 'Fixing 404 errors is a usability issue. Patching them up will result in a better user experience, more useful traffic to your site, and, potentially, more revenue.', 'cpseo' ); ?></p>
+
+<p><?php esc_html_e( 'The great thing about the 404 Monitor in Classic SEO is that it logs each 404 error and the URL that gave the error. It also logs how many times someone has attempted to visit a particular non-existent URL.', 'cpseo' ); ?></p>
+
+<p><?php esc_html_e( 'And then, in conjunction with the Redirections module, it allows you to set up a proper redirect to an alternative page.', 'cpseo' ); ?></p>
 
-<p><?php esc_html_e( 'Maybe you changed the URL of an article to make it more appealing to the search engines.', 'cpseo' ); ?></p>
 
-<p><?php esc_html_e( 'Whatever the cause, the result is a disappointed reader. So fixing 404 errors is a usability issue. Patching them up will result in more useful traffic to your site, and for many sites, that means more revenue.', 'cpseo' ); ?></p>
 
diff --git a/includes/modules/redirections/views/help.php b/includes/modules/redirections/views/help.php
index 65570ca..a13c7ed 100644
--- a/includes/modules/redirections/views/help.php
+++ b/includes/modules/redirections/views/help.php
@@ -10,11 +10,23 @@
 
 <h3><?php esc_html_e( 'Redirections', 'cpseo' ); ?></h3>
 
-<p><?php esc_html_e( 'An HTTP redirection is a magical thing. When you visit a URL with a redirection, your browser automatically jumps to a new address.', 'cpseo' ); ?></p>
+<p><?php esc_html_e( 'When you visit a URL with a redirect in place, your browser will automatically go to a different address.', 'cpseo' ); ?></p>
 
-<p><?php esc_html_e( 'You’ve seen this before with URL shortener services like bit.ly – instead of typing a long address, you type a short one. Your browser is automatically redirected to a different site, and it happens faster than you can blink.', 'cpseo' ); ?></p>
+<p><?php esc_html_e( 'For example, you could enter www.example.com/page-a in your browser but you could be redirected to www.example.com/page-b or even www.anotherexample.com/page-z.', 'cpseo' ); ?></p>
 
-<p><?php esc_html_e( 'HTTP redirections are powerful tools in SEO, and they have lots of other uses, too. You can read about why that’s a good idea in this article.', 'cpseo' ); ?></p>
+<p><?php esc_html_e( 'This is a very common occurrence when browsing the web.', 'cpseo' ); ?></p>
 
-<p><?php esc_html_e( 'Classic SEO makes it easy to set up HTTP redirects – in this article, we show you how.', 'cpseo' ); ?></p>
+<h3><?php esc_html_e( 'Why redirect?', 'cpseo' ); ?></h3>
+
+<p><?php esc_html_e( 'Redirects are very common and are an essential part of the web.', 'cpseo' ); ?></p>
+
+<p><?php esc_html_e( 'Let\'s say we\'ve just moved our website to a new address and we want to shut down the old one.', 'cpseo' ); ?></p>
+
+<p><?php esc_html_e( 'If we don\'t set up redirects, all those pages from the old site will give a 404 Not Found error and, more significantly, you stand to lose all those customers or visitors you worked so hard to gain. Not ideal is it?', 'cpseo' ); ?></p>
+
+<p><?php esc_html_e( 'So, what we need is for those old links to redirect to the same content on our new site. And, we need a way to tell search engines that these redirects are either temporary or permanent.', 'cpseo' ); ?></p>
+
+<p><?php esc_html_e( 'HTTP redirections are powerful tools in SEO, and they have lots of other uses too.', 'cpseo' ); ?></p>
+
+<p><?php esc_html_e( 'The Redirections module in Classic SEO makes it all as simple as possible.', 'cpseo' ); ?></p>
 
diff --git a/includes/modules/sitemap/views/help.php b/includes/modules/sitemap/views/help.php
index 1747c22..ef0f80a 100644
--- a/includes/modules/sitemap/views/help.php
+++ b/includes/modules/sitemap/views/help.php
@@ -9,17 +9,23 @@
 ?>
 <h3><?php esc_html_e( 'Sitemaps', 'cpseo' ); ?></h3>
 
-<p><?php esc_html_e( 'XML sitemaps are files that serve a single purpose - to help search engines find and index all of your content.', 'cpseo' ); ?></p>
+<p><?php esc_html_e( 'XML sitemaps are files that help search engines find and index all of your content.', 'cpseo' ); ?></p>
 
-<p><?php esc_html_e( 'Once upon a time, search engine bots would have a hard time finding all the content on a site. Many sites had a weak internal link structure, and that meant that some pages or posts would go overlooked.', 'cpseo' ); ?></p>
+<p><?php esc_html_e( 'In many cases, if you have good internal linking, search engines will be able to discover content on your site without the need for a sitemap. Nevertheless, a sitemap is still recommended.', 'cpseo' ); ?></p>
 
-<p><?php esc_html_e( 'The early search engines gave us forms where we could enter our URLs one at a time. They\'d feed this information into their queue of pages to crawl, and the pages would get visited and indexed at some point.', 'cpseo' ); ?></p>
+<p><?php esc_html_e( 'If your internal linking isn\'t perfect, you can easily end up with pages that don\'t have any links pointing to them, making them hard to find. ', 'cpseo' ); ?></p>
 
-<p><?php esc_html_e( 'Typing in dozens or even hundreds of URLs was a tedious job - in fact, many companies popped up offering to submit your site to the search engines, because who had the time to do that?', 'cpseo' ); ?></p>
+<p><?php esc_html_e( 'An XML sitemap lists your website\'s important pages, making sure search engines can find and crawl them all.', 'cpseo' ); ?></p>
 
-<p><?php esc_html_e( 'When Google appeared on the scene, people soon noticed that submitting pages didn\'t lead to fast crawls. Linking to a page from another page (even on the same site) would get the bot to visit quickly.', 'cpseo' ); ?></p>
-
-<p><?php esc_html_e( 'To solve the problem of getting pages crawled and indexed, many webmasters created a "sitemap". It was an ugly HTML page with nothing but links to all the site\'s content. It was a bit of an eyesore, and human users had little use for it. But it helped the spiders to find pages and it got them into the index.', 'cpseo' ); ?></p>
-
-<p><?php esc_html_e( 'Search engines realized that people were building these pages that didn\'t do anything for human visitors, and they decided to cut us a break. They invented a new XML based file that we could use to communicate directly with the robots. We could announce our new pages without cluttering up our sites with pointless pages.', 'cpseo' ); ?></p>
+<h3><?php esc_html_e( 'Where is my sitemap?', 'cpseo' ); ?></h3>
 
+<p>
+	<?php
+	printf(
+		/* translators: link to sitemap */
+		__( 'Classic SEO creates a file called sitemap_index.xml which can be viewed here <a href="%1$s" target="_blank">%2$s</a>.', 'cpseo' ),
+		get_site_url() . '/sitemap_index.xml',
+		get_site_url() . '/sitemap_index.xml'
+	);
+	?>
+</p>
\ No newline at end of file