Documentation & FAQ for PWT SEO
After installing PWT SEO all necessary plugins are already enabled. You can head straight to your Joomla articles or menu-items and a tab called SEO Score will be available. As soon as you enter an SEO keyword or keyphrase, your SEO score will immediately be calculated. Simply following the instructions of the plugin should result in ever higher scores. This should be pretty self-explanatory.
You can see an overview of all your SEO score in the component overview for PWT SEO.
Note: currently you need to either use TinyMCE or JCE to make the SEO Score visible!
PWT SEO hardly requires any configuration, it works out of the box for most users. However, a few items are configurable. Go to Plugins >> PWT SEO:
In the advanced tab you can also set minimum and maximum values for your page/title and metadescription counters. Also, in some cases, you may use the title-selector fiels:
In most cases you don't need this. Only if you use a template that does not fill the article title in a normal way, you can indicate the HTML-element that is displayed. As an example, it could be something like "uk-article-title a".
You can access the component view via Components >> PWT SEO:
Mostly, you will work with the Articles or Menu´s views, as this gives you an overview of how your articles or menu´s are doing:
Clicking an article brings you directly into the Joomla core article editing view. Exiting the article you will return into this view. Note that you can just as easily work from the Joomla Article overview if you want.
Note: you can also use Custom URLs, scroll down to see how that works.
Inside every article you will now see an SEO Score tab:
The score will only be calculated if you have filled in a keyword for the tab. Scores range from 0 to 100 for perfectly optimized articles. Also a color-rating is added to be able to roughly charaterize the scores (red=bad, orange=reasonable, green=OK).
By the way, if there is an update for the PWT SEO keyword plugin, this could be reason for updated calculations for your SEO Scores. You will see this in the PWT SEO Articles overview. Your score will have a small asterix, that indicated this when you hover over it. To recalculate your rankings, you will have to enter and save the article.
For every field applicable, a character counter is added at the end of the field:
This feature is available in the fields for:
It lists both the current character count and the advised maximum length of the field. Note that this maximum is a conservative maximum to be on the safe side. Going a few characters beyond is not critical. Note the green color in the counter. Going over the configured maximum count gives an orange / red color.
Also, be aware that for the count for the Article Title field, it does not check whther you have set your Sitename to prefix or append your page titles.
The whole SEO Score is dependant on the field called SEO keyword or keyphrase:
It is very important to think very carefully about what you fill in here: this is really what you should do yourself. Make sure it is very relevant and specific for the text you will be writing! If you choose an irrelevant keyword, the whole SEO score is useless. You can either fill in a single keyword here, or a keyphrase consisting of multiple words (we suggest no more then 3 words).
Note that below the scores on the left, there is an overview of the top-5 most used words on the page. If you click one of these, it is set as the keyword for this article:
By the way, an en excellent article on keyword research is available on the Moz.com website.
The next field is the Override title field. If you leave it set to the default of No, the page title as generated by Joomla will be used (usually derived from the article title). However, if you want to improve it, you can set the value to Yes. A new field will show, allowing you to fill in an improved page title:
Note that the page title is the field that controls the title of the snippet in Google Search. Often this field is referred to as the Browser Page Title.
The field Canonical setting is used to configure you canonical URL. The default setting is to use the setting in the PWT SEO plugin, but whether you have set sel-referencing canonicals off or on there, you can override the setting here:
You can even link to custom URLs, either internal or external.
The field Show Open Graph tags is used to specify Open Graph information. This controls how your page snippets will display in social media like Facebook, Twitter and Google+. If you leave it to No, no information will be generated. However, setting it to Yes opens up fields to generate it:
Note that only the Facebook fields show in the screenshot, but Twitter and Google are also included. For most users, these fields will suffice. However, advanced users may want to use more fields. Those users can change the PWT SEO plugin settings and set it to Advanced Mode. This will remove the pre-set fields shown below and offer a new set of fields that you will have to fully popluate yourself:
Based on your settings for page title and metadescription and the calculated URL, a preview is generated of how your article's URL should look like in Google Search:
You will have to keep in mind that this is based on the assumption that you filled in relevant values. If Googles thinks these values are not relevant for the article, it will dispose your settings and generate some text.
For the URL, keep in mind that this is the URL that is the first URL found by the Joomla Router. If you create more menu-items to the same article, it cannot show all. You should prevent this situation anyhow, otherwise you will have duplicate content issues.
Next to the SEO Score as shown in the tab itself, full details of the individual components from which the score is calculated are shown as well:
You may have already noticed that these scores are constantly updating as you make changes to text or metadata. You don't have to hit the Save button for this. We tried to make the instructions as clear as possible, so they should not need further explanation.
Finally, there is a section in the SEO Score tab for the Resulting page:
Here, the plugin makes a quick analysis of the full HTML of the URL the article will be shown on. Usually, this will be the actual article, PLUS the surrounding modules. As you cannot modify the modules output per individual article, we made this section not count towards the SEO score, but it gives you a rough indication of any issues the modules could give you.
Also, this feature can help you if your articles contain non-valid HTML: many page-builders, like Yootheme Pro, SP Page Builder or more have funny HTML inside the actual article database, which is only interpreted into correct HTML on the front-end. With the resulting page feature, you still have an idea of the correct implementation of your SEO keyword(s).
In version 1.1, Custom URL's were introduced. This is an excellent feature to also optimize non Joomla-core content. Though the feature does not contain all features that are available inside Joomla articles, it can still optimize the page with optimized page title's, canonical URLs or Open Graph data. Also you can check the resulting page compared to your keywords:
You can configure structured data inside your articles. For this purpose, click the Customize button next to Structured Data:
When you do so, a screen will pop up where you can populate all the fields you need. First of all, you can choose between different types of structured data. The options currently available are the following:
Note that you can use the + icon to set multiple types of structured data per article if needed.
Based on your choice, the set of fields to fill in is set and you can customize these. As an example, this is how the Corporate contact option looks like:
Advanced users can use PWT SEO to set up Google Tag Manager Data Layers to push data from their site into GTM and Analytics. To set these, don't forget to enable the feature and set your GTM-container-ID in the PWT SEO plugin settings. Then go to the component view and create your first data layer. In the example below I simply type in some dummy data, but of course this should correspond with the data you want inside your GTM account.
This is what you see if you create a new data layer:
The layer should have a Label and a Name. You can choose whether the layer is Required or not and you should use a Type (default is Text). You can pre-populate the Default value or leave it empty.
If you save the layer and then go to the PWT SEO tab inside an article, you will see the layer if you click the Configure button next to Datalayers:
As I specified a default value, you see it here, and you can choose to either leave it or edit it.
PWT SEO contains an option to check whether the site has a valid sitemap submitted to Google Search Console. To enable the feature, you have to go to the options button in the PWT SEO component:
Note: you have to set up the Web app correctly, as the component area may become unavailable if you have set the credentials and authorizations incorrectly.
Obviously you will have to fill in the Google API credentials here. To do so, first go to https://console.developers.google.com. Then create a new project of the type Web app. Make sure to fill in the fields specific for your site and make sure the app is authorized for your domain. Once this is done, you will be shown a Client ID and a Client secret that you have to fill in in the component area.
Here are the details of the app inside the API Console so that you can copy the details (note that domain, email address and credentials have been wiped red):
Make sure to fill in the redirect URL (the URL of the component area of PWT SEO): http://example.com/administrator/index.php?option=com_pwtseo
Fill in email and homepage:
Authorize your domain:
Then when you access the PWT SEO component for the first time, you may have an initial warning:
If so, simply go the selected URL and click Yes to approve access with your Search Console account.
Once this is done, you will see whether you indeed have a valid sitemap submitted:
Sitemap available: Yes
PWT SEO works with the Joomla core automatic update system, but you need to set up the extension for this. To do so, you need to enter your download ID into the configuration.
You can find your download ID in the PWT dashboard at extensions.perfectwebteam.com/dashboard (make sure you are signed in). There is a download ID for every extension. Copy the download ID.
Then go to Components >> PWT SEO and click the Options button at the top-right. Then go to the Update tab:
Then simply paste your download ID.