PWT SEO

Documentation & FAQ for PWT SEO

General Usage

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!


Initial Configuration

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:

plugin settings pwt seo3

  • Advanced mode is switched off by default. If you switched it on, the standard Open Graph fields in the SEO Score tab are replaced by fields that you can use fully customized. This is only needed for very experienced users.
  • Show counters: By default, counters for the character count are shown next to the fields for article title, pagetitle and metadescription. If you want, you can disable this feature.
  • Self referencing canonical: Joomla does not use canonical URLs in most of your pages. In many cases though, they have good use (especially when using anchor links within a page), but also many SEO experts (not all) advise to implement them. With this parameter, your articles will have self-refererencing canonicals. You can also disable the default behaviour here. In both situations, it is still possible to override the behaviour in every single article.

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:

title selector

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".


Component view

You can access the component view via Components >> PWT SEO:

pwt seo dashboard2

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:

component overview

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.


SEO Score

Inside every article you will now see an SEO Score tab:

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.

 


Character counters

For every field applicable, a character counter is added at the end of the field:

character counter2

This feature is available in the fields for:

  • Article Title
  • Page Title
  • Metadescription

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.


Field: SEO keyword or keyphrase

The whole SEO Score is dependant on the field called SEO keyword or keyphrase:

seo keyword 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:

automatic keyword

By the way, an en excellent article on keyword research is available on the Moz.com website.


Field: Override title

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:

override 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.


Field: Canonical setting

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:

canonical setting

You can even link to custom URLs, either internal or external.


Field: Expand OG info

The field Expand OG info 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:

expand open graph info

Note that only the Facebook fields show here, 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:

advanced mode


Google Search result preview

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:

google search result preview

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.


SEO Score results

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:

seo score details

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. 


Resulting page

Finally, there is a section in the SEO Score tab for the Resulting page:

resulting page score3

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).


Custom URL'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:

custom url


Sitemap check

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:

google oauth

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):

google oauth2

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 

google oauth3

Fill in email and homepage:

google oauth4

Authorize your domain:

google oauth5

Then when you access the PWT SEO component for the first time, you may have an initial warning:

google oauth6

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


Automatic Joomla updating

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:

automatic updates

Then simply paste your download ID.


FAQ and known issues

  • Can I use PWT SEO together with a SEF extension like SH404SEF?
    Yes, you can, but be aware that the extensions overlap. Nothing will break, but the metadata management part is available in both extensions. If you have added your page-titles and metadescriptions in SH404SEF, PWT SEO cannot read them (yet) and will calculate incorrect SEO scores (for page title and metadescription, the other fields work fine). As long as you manage all metadata in the Joomla core, you can use both extensions independantly. In that case you have SH404SEF managing your URL's while PWT SEO will manage metadata and calculate correct SEO scores.
  • I do not see my SEO Score 
    Make sure you use either TinyMCE or JCE as your editor. Without an editor, the tab may not display correctly.
  • My new article does not have a score for the URL
    If you create a new article, PWT does not (yet) take into account the URL. To do so, first save the article so that an alias is generated for the article (or create one yourself). Only then the score for the URL is also calculated.