🐪 WordPress Redirect Plugin for SEO - Documentation

WordPress Redirect Plugin for SEO documentation version: 2.0.x

 Introduction


Welcome to Llama Redirect Plugin documentation page. Here we covered almost everything that you easily you can set up and use our plugin. If you have any questions that are beyond the scope of this documentation page, please feel free to contact us.

 Installation


To install the plugin, please follow Wordpress Plugins › Lrp Docs installation guide. This will help you to install the plugin step by step.

 Llama Assistant


 How to start

To activate Llama Assistant, please follow these steps:

  1. Navigate to "Llama Assistant" tab

  2. Read the description, what will happen after you enable Llama Assistant

  3. Click on blocks to read more about the data will be collected from your plugin's settings

  4. Click "Confirm & Enable Llama Assistant"

How to start
 Settings

There are two important settings which are used in Llama Assistant:

SettingsLlama Assistant

(Turn On / Turn Off)

Enable / Disable Llama Assistant in your plugin. If Llama Assistant is enbaled, then syncronization is active and Llama Machine Learning service will connect to your website time to time.

This connection is named as "Syncronization", which actually represents following process:

  1. Llama Assistant schedules a syncronization event between our Machine Learning service and your plugin;

  2. We send HTTP request to your plugin, which contains an access token, issued when you active the Llama Assistant;

  3. If access token is valid, then your plugin prepares the statistical data and sends back to Llama Machine Learning Service;

Read more about syncronization process - here

Llama Assistant Auto Apply

(Turn On / Turn Off)

Enable / Disable Llama Assistant permission to make changes in your plugin settings.

If you enable, then Llama Assistant will have required permissions to make changes.

The process is following:

  1. When your statistical data is received on Llama Machine Learning Service side, it is being analyzed and classified;

  2. If our Machine Learning algorithms discover a personal suggestion for you, it will be sent as personal message in web chat interface;

  3. If you enabled Auto Apply, then Llama Assistant will send HTTP request to your plugin with a specific command list to process them;

  4. Your plugin will receive this structured information (called "payload") and will process each task;

Such tasks could be "UPDATE", "DELETE" or "INSERT" a setting or an item.

 Ask for help

When you enabled Llama Assistant, you will see a welcome message from Llama, describing the common structure.

To ask Llama Assistant to help you, just type /help or using free text message, like I need help

After this, you'll receive an answer like, Sure. Please write down what you like to receive help with?

Now, just type your question and Llama Assistant will check all our support documentation, including Installation manual, Users manual, website knowledge base, our blog and other resources to find a relevant answer for your question.

Here is an example:

Ask for help
 Other commands

Llama Assistant understands specific buil-in commands. The logic is quite equal to Slack chat bots, or Telegram bots.

To explore all known commands, just send a message /all-commands.

Llama Assistant will send a reply to you with full list of commands available right now.

Alternatively, you can click on Menu icon on the bottom of the chat box - and you will see active buttons below the chat.

For the quick usage of commands, start typing / ... "slash" symbol and there would be autocomplete list of commands matching your current message.

Other commands

The list of commands might change, because we update this functionality on the regular basis.

Here is the list of main commands, you should have in your Llama Assistant chat box:

  1. /help - Search an answer in knowledge base and in documentation

  2. /all-commands - View list of all known commands

  3. /my-profile - Display my profile data

  4. /all-plugins - List all LlamasApps plugins

  5. /about - About Llama ML Assistant Bot

  6. /stop - Unsubscribe from ML Assistant

  7. /update-data - Synchronize data manually

  8. /auto-on - Activate automatic application the suggestions you receive from Llama Assistant

  9. /auto-off - Deactivate automatic application the suggestions you receive from Llama Assistant

  10. /http-codes - More information about HTTP codes

  11. /move-404 - Create new redirect rules from your 404 log

  12. /tracking-on - Enable tracking for all redirects

  13. /tracking-off - Disable tracking for all redirects

  14. /redirects-on - Activate all redirects, that you currently have

  15. /redirects-off - Deactivate all redirects, that you currently have

 Synchronization process

The synchronization process works one way only.

When you enable Llama Assistant, we create a scheduled synchronization with your website. Synchronization is processed every hour, but might be changed automatically, based on the data volume, total amount of active users and other reasons to keep our system healthy using load balancers.

The synchronization process consists of following steps:

  1. Llama Assistant does HTTP request to your website. The URL address is the direct link to a file in this plugin (the file location is shown on the welcome screen, before you enable the Llama Assistant).

  2. In the request, we send access token, which was issued by Llama Assistant when you register

  3. Your plugin file compares the access token, received from Llama Assistant and that you actually have in your WordPress options.

  4. If access token matches, we check if Llama Assistant is enabled on your side. If not, we update your status on our side and won't make synchronization request again.

  5. If Llama Assistant is enabled, your plugin file fires a plugin synchronization function

Plugin synchronization function

We suggest you to check the source code of this function to be sure, which data is being collected during the synchronization request.

Read more about data synchronization here

This function prepares your statistical data - this is all the records in this plugins database tables. All data is being compressed and sent to Llama Machine Learning Service.

Data analysis

Then we analyze your data to classify it and to find some errors or suggestions. Read more about the technology here

In the end of this process, Llama Assistant might send you a message with some suggestions using web chat.

 How to turn it off

There are a few ways how it might happen

Turn Off
  1. Navigate to "Llama Assistant" tab in the plugin menu

  2. Click "Open Settings"

  3. Find "Llama Assistant" row

  4. Click Turn Off

After this there might be one more HTTP synchronization call from Llama Assistant, which will receive information that you disabled Llama Assistant and the synchronization with your website will be turned off.

Plugin Deactivate / Uninstall

If you uninstall or deactivate the plugin, you will start from beginning and it will take some time to receive relevant suggestions, as described above.

 Plugin video


 Response codes


Using Llama Redirect Plugin you can select different types of server response codes.

Most popular codes
301301 - Moved Permamently. Wiki: This and all future requests should be directed to the given URI.
302302 - Found. Wiki: Tells the client to look at (browse to) another URL. 302 has been superseded by 303 and 307. This is an example of industry practice contradicting the standard. The HTTP/1.0 specification (RFC 1945) required the client to perform a temporary redirect (the original describing phrase was "Moved Temporarily"), but popular browsers implemented 302 with the functionality of a 303 See Other. Therefore, HTTP/1.1 added status codes 303 and 307 to distinguish between the two behaviours. However, some Web applications and frameworks use the 302 status code as if it were the 303.
307307 - Temporary Redirect. Wiki: In this case, the request should be repeated with another URI; however, future requests should still use the original URI. In contrast to how 302 was historically implemented, the request method is not allowed to be changed when reissuing the original request. For example, a POST request should be repeated using another POST request.
Other response codes
300300 - Multiple Choice. Wiki: Indicates multiple options for the resource from which the client may choose (via agent-driven content negotiation). For example, this code could be used to present multiple video format options, to list files with different filename extensions, or to suggest word-sense disambiguation.
303303 - See Other. Wiki: The response to the request can be found under another URI using the GET method. When received in response to a POST (or PUT/DELETE), the client should presume that the server has received the data and should issue a new GET request to the given URI.
304304 - Not Modified. Wiki: Indicates that the resource has not been modified since the version specified by the request headers If-Modified-Since or If-None-Match. In such a case, there is no need to retransmit the resource since the client still has a previously-downloaded copy.
305305 - Use Proxy. Wiki: The requested resource is available only through a proxy, the address for which is provided in the response. Many HTTP clients (such as Mozilla and Internet Explorer) do not correctly handle responses with this status code, primarily for security reasons.
308308 - Permanent Redirect. Wiki: The request and all future requests should be repeated using another URI. 307 and 308 parallel the behaviors of 302 and 301 but do not allow the HTTP method to change. So, for example, submitting a form to a permanently redirected resource may continue smoothly.

 

While testing please note that 301, 308 (Permanent redirects) are "remembered" by most of all browsers. This means if you create and test your redirect using 301 or 308 server response code - your browser probably cache this. And when you delete this redirect setting or even UNINSTALL the plugin - browser will STILL redirect your URL.

 User friendly interface


 Inline help tooltips

Plugin comes with inline help suggestions describing the certain function.

Inline help tooltips
 Quick buttons in Admin Navigation Panel

You can quickly create new redirects from Top navigation panel

  • Turn on: URL redirects > Settings > Show [Quick Add] > Yes

  • Turn off: URL redirects > Settings > Show [Quick Add] > No

Quick buttons in Admin Navigation Panel
 Quick button in Admin Post Editor

 WordPress 5.0 compatible

  • Turn on: URL redirects > Settings > Show button in Post page? > Yes

  • Turn off: URL redirects > Settings > Show button in Post page? > No

Quick button in Admin Post Editor

 Start using Llama Redirect Plugin


 Your first redirect

To create your first redirect with the plugin, please follow these steps:

  1. Navigate to Plugins home page (Click on URL redirects on the left navigation bar in admins panel)

  2. Click button "Add" or Navigate to "Add URL" tab on the top

  3. Fill-in your redirect settings (most important to add Link from and Link target) and click "Add" button on the bottom

  4. Thats it! Now this redirect is active and you can test it using your browser

 Add URL fields
Response codeSpecify server response code which will be executed
Link fromType URL to catch redirects from.
Link targetType full URL to target redirect visitor.
Track link?If checked, clicks will be recorded into Statistics tab
BrowserUse this redirect rule only if clients browser is in this list
Operating systemUse this redirect rule only if clients OS is in this list
Referer domainType domain name which indicates the last page the visitor was on (the one where visitor clicked the link)
WordPress user roleUse this redirect rule only if a WordPress user role is in this list
Time from, Time toTime of the day when this redirect rule is active from - to.
MonthUse this redirect rule only if Month now is in this list
YearUse this redirect rule only if Year now is in this list
GET parameterUse this redirect rule only if URL matches this GET attribute
IP rangeUse this redirect rule only if visitors IP is in this IP range.

 Settings


 Match any URL

Use "Link from" field to specify the URL where user will be redirected from. You can type here any URL on your site, even if this URL actually not exists

 Wildcard supported!

Match any URL
 Any target URL

Target URL is the redirection target - where user will be transferred if redirection rule is active. This URL could be your local URL address (e.g. some other page) or it could be some external resource. For example: a link to your Facebook page.

Any target URL
 Browser matching criteria

When you have an active redirection rule, the plugin is using $_SERVER['HTTP_USER_AGENT'] to define the visitor's browser.

So you can select any Browser from this list to focus the redirect rule to a specific browser:

  • Internet Explorer
  • Firefox
  • Chrome
  • Safari
  • Edge
  • Opera
  • Netscape
  • Maxthon
  • Konqueror
  • Handheld Browser
Browser matching criteria
 OS matching criteria

When you have an active redirection rule, the plugin is using $_SERVER['HTTP_USER_AGENT'] to define the visitor's operating system.

So you can select any OS from this list to focus the redirect rule to a specific OS:

Windows 10, Windows XP, Windows 2000, Windows NT, Windows Server 2003, Windows Vista, Windows 7, Windows CE, Windows Media Center, Windows, Windows ME, Windows 98, Windows 95, Java, Solaris, DOS, Unix, Mac OS X, Macintosh PowerPC, Mac OS, SunOS, BeOS, RISC OS, OS/2, FreeBSD, OpenBSD, NetBSD, IRIX, Plan9, OSF, AIX, GNU Hurd, Linux - Fedora, Linux - Kubuntu< Linux - Ubuntu, Linux - Debian, Linux - CentOS< Linux - Mandriva, Linux - SUSE, Linux - Slackware (Dropline GNOME), Linux - ASPLinux, Linux - Red Hat, Linux, AmigaOS, Amiga, PalmOS, WebTV, Dreamcast OS

OS matching criteria
 Referer match

The field "Referer domain" is used for analyzing the $_SERVER['HTTP_REFERER'] value. If your URL is placed somewhere on Internet - on any other domain, when user clicks to your link in most cases your site gets the information of the previous domain / website. Using this setting you can activate the redirect rule if visitor's referer domain matches your criteria.

 Wildcard supported!

 User role

When someone is accessing your WordPress website pages it is possible to determine the WordPress user role. Using the field "WP user role" you can target the redirect rule on a specific WP role, and this rule won't be active for the other roles

Read more about WordPress user roles here - https://codex.wordpress.org/Roles_and_Capabilities

Supported roles: Administrator, Editor, Author, Contributor, Subscriber

 Time interval redirects

The redirect rule can be active during some time frame only. For example you want this redirect rule to be active from 12:00 to 13:00. Note that time intervals have to be in 24H format.

Time interval redirects
 Day of the week redirects

The redirect rule can be active in a specific days of the week. For example activate the redirect rule on Monday, Tuesday only.

Supported days: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday

Day of the week redirects
 Monthly redirects

The redirect rule can be active in a specific Month. For example activate the redirect rule in August only.

Supported months: January, February, March, April, May, June, July, August, September, October, November, December.

Monthly redirects
 GET Any parameter
GET parameter is the attribute of URL which comes to the original URL link. For example: https://my-website.com?key=value - the key is attribute key, and the value is the value of key.

Using the field GET parameter you can specify exact GET parameter. For example activate the redirect rule only if utm_source is specified.

 Wildcard supported in GET value!

 IP range

You can focus activate the redirect rule only if visitor's IP is in the list. Type the IP from and IP to to cover the range of IP addresses.

Example: 84.237.150.150 is in the range of 84.237.100.100 - 84.237.160.100

Use our IP range tester online firstly to check if your IP range settings meet your idea.

 Enable force HTTPS

Using the redirect plugin you can force redirect all the pages to their HTTPS version.

Navigate to Settings > Enable force HTTPS > Yes

This will transfers the trafic from HTTP pages to HTTPS. Please note that your website must have the valid SSL HTTPS certificate to handle this in a propper way.

Enable force HTTPS
 Use wildcards

Wildcard is supported in:

  • Link from
  • Referer domain
  • GET value

Examples of using wildcard:

*Matches anything
a*Matches anything starting with "a". For example: "some_value*" will match "some_valuetetext", "some_value123" etc
/product/*/Matches anything between slashes. This example will match: my-website.com/product/my-product/ , my-website.com/product/any-other-product/ etc

Use our Online Wildcard Tester Tool firstly to check if your wildcard meets your idea.

 Redirect rule analysis

When a redirect rule found matching the source URL (Link from), all your settings are being analyzed to meet the visitor's values.

Explore the following structure how plugins are making the decision to apply the redirect rule to this visitor or not. Plugins go within all these steps and only if all steps have a match then redirect rule is active and a visitor is being transferred to a different URL (Link target). Please note that letters are important - lower case "a" is NOT equal to upper case "A".

browserIf you selected some browsersVisitors browser is in your list
osIf you selected some Operating SystemVisitors OS is in your list
referer domainIf you typed some referer domainIf you use "*" (anything) or Visitors referer is defined and it matches your direct or wildcard rule
wp roleIf you selected some WordPress roleEach role is checked using the WordPress current_user_can()
time fromIf you typed time fromIf time now (on your server) is greater than you specified
time toIf you typed time toIf time now (on your server) is less than you specified.
dayIf you selected a DayIf day now is in your list
monthIf you selected a MonthIf month now is in your list
yearIf you selected a YearIf year now is in your list
GET key + GET valIf you typed GET key + GET val valuesIf you use "*" (anything) as Value, then value is always match. Key must have full match with the visitors URL.
GET val onlyIf you typed GET value only.If visitors URL has any parameter which value is equal to your specified one.
GET key onlyIf you typed GET key only.If visitors URL has any key which is equal to your specified one.
IP from + IP toIf you typed IP from and you typed IP to - which becomes an IP rangeIf visitors IP is in range between your specified IP from and your specified IP to. Is used ip2long()
IP from onlyIf you typed IP from only - one IP matchIf visitors IP is the same as you specified.
IP to onlyIf you typed IP to only - one IP matchIf visitors IP is the same as you specified.

 404s


 404 (Not Found) Log

When someone is accessing the your websites URL which not exists, WordPress reply a 404 server response code to a visitor. Llama Redirect Plugin "catches" these events and records them into the 404 LOG

Here you can see the list of 404 (Not Found) pages which were accessed by your visitors. The table consists of:

  • URL which was opened by a visitor
  • Date time of event
  • [Add redirect] button - to create new redirect using this URL

To access 404 log. Navigate to: "404s" tab in the plugin.

404 (Not Found) Log
 Quick reactions

You can easily create new redirect rules from the 404 Log page - just click on Add redirect button to see the well-known Add URL form.

 Import / Export


 Import

To import Redirect rule settings in bulk use following steps

  1. Navigate to: Add URL

  2. Click on Download Example - to verify that your file structure is equal to the required one

  3. If you don't have any redirects, you should add one to see it in Example file - because it is being created using your data

  4. Then click Choose files and click Upload

  5. All redirect settings in your file will be created and you will them in URL redirects (plugin's home) page

 Export

To export all your Redirect rules settings use following steps

  1. Navigate to: URL redirects (plugin's home) page

  2. Click on Export CSV

  3. You will get a CSV file with all your redirects in it.

 Support


If you have any questions that are beyond the scope of this documentation page, please feel free to contact us.


Download PDF

Download this document in PDF format to have access to it at any time you need

Buy this plugin

Free

0 $/year

Email & Help Center Support

Professional

2999 $/year

Priority Email & Help Center Support

Machine Learning

599 $/month

Priority Email & Help Center & Chat Support


Other useful resources:

Installation manual

Step-by-step how-to install guide. Using WordPress Admin Dashboard, Installation from ZIP file, FTP installation

READ MORE

Performance tests

Security tests and benchmark full report, including loading MySQL, CPU, RAM, Memory charts, Xdebug test schemas

READ MORE

Explore all features

The most advanced SEO redirect plugin on the market, Redirect plugin comes with over 34 features

READ MORE