EXT: RealURL management¶

What does it do?¶

Allows you to delete and change the URL's created by RealUrl extension.

It is useful:

• after site renaming
• if RealURL create a URL that you don't like
• if you are done with testing and you want to insert real data

Control environment¶

Control environment consists of this modules:

• Pages
• Aliases
• Errors
• Redirects
• RealURL-Table Clean
• About

Access to this modules can be allowed or disallowed in TSconfig for user or group.

Admin user has the access to any module always granted.

Pages¶

In this module it is possible to view and delete URL's generated by RealUrl for pages and to change the already generated Speaking URL path segment for every page. The user has default the access to this module denied but it is possible to allow it with this (user or group)TSconfig:

realUrlManagement.pages.show=1

In this frame the page(branch) can be chosen with which we will work.

Select the depth of view and processing from page(branch) selected in (1).

Delete record.(The user has default no access to this action but it is possible to grand access with this (user or group) TSconfig: realUrlManagement.pages.delete=1 )

Delete all shown RealUrl records.(The user has default no access to this action but it is possible to grand access with this (user or group) TSconfig: realUrlManagement.pages.deleteShown=1 )

Edit the Speaking URL path segment generated for this page.(see the “Speaking URL path segment editing” section.)(The user has default no access to this action but it is possible to grand access with this (user or group) TSconfig: realUrlManagement.pages.edit=1 )

Edit the expiration date. (see the “Expiration date editing” section.)(The user has default no access to this action but it is possible to grand access with this (user or group) TSconfig: realUrlManagement.pages.changeExpire =1 )

Create a new record. If you use this action, current record will be expired and new record will be create and open for editing. So can you make more record to one page. It is useful if you want create new record but you will let the old record remain valid while it is indexed e.g. by Google.(The user has default no access to this action but it is possible to grand access with this (user or group) TSconfig: realUrlManagement.pages.create =1 )

Expire all shown RealUrl records.(The user has default no access to this action but it is possible to grand access with this (user or group) TSconfig: realUrlManagement.pages.expireShown=1 )

Every RealUrl record for page consist of this parts:

Aliases¶

In this module it is possible to view, edit and delete aliases for tables shown on frontend (e.g. tt_news or tt_adress tables).The user has default the access to this module denied but it is possible to allow it with this (user or group)TSconfig:

realUrlManagement.aliases.show =1

Table for which the alias was created

Delete record.(The user has default no access to this action but it is possible to grand access with this (user or group) TSconfig: realUrlManagement.aliases.delete =1 )

Edit the alias.(The editing process for aliases module is similar to editing process for pages module. See “Speaking URL path segment editing”, but here the full alias is edited and not only a part(path segment).)(The user has default no access to this action but it is possible to grand access with this (user or group) TSconfig: realUrlManagement.aliases.edit=1 ).

Sort aliases. By clicking on this element the aliases will be sorted(ascending or descending) by field right to this element.

Currently selected sorting field. By clicking on this element you switch between ascending and descending sorting.

Edit the expiration date. (see the “Expiration date editing” section.)(The user has default no access to this action but it is possible to grand access with this (user or group) TSconfig: realUrlManagement.aliases.changeExpire =1 )

Create a new alias. If you use this action, current alias will be expired and new alias will be create and open for editing. So can you make more aliases to one id. It is useful if you want create new alias but you will let the old alias remain valid while it is indexed e.g. by Google.(The user has default no access to this action but it is possible to grand access with this (user or group) TSconfig: realUrlManagement.aliases.create =1 )

Errors¶

In this module it is possible to view and delete error logs from RealUrl extension and to clear the counter variable for error logs. The user has default the access to this module denied but it is possible to allow it with this (user or group)TSconfig:

realUrlManagement.errors.show =1

Delete record.(The user has default no access to this action but it is possible to grand access with this (user or group) TSconfig: realUrlManagement.errors.delete =1 )

Clear the Counter. Here you can set the Counter to 0. This is useful after error correcting to discovery if this error occurs again.(The user has default no access to this action but it is possible to grand access with this (user or group) TSconfig: realUrlManagement.errors.clearCounter =1 )

Sort errors. By clicking on this element the errors will be sorted(ascending or decending) by field right to this element.

Currently selected sorting field. By clicking on this element you switch between ascending and descending sorting.

Redirect¶

In this module it is possible to view, edit and delete records from tx_realurl_redirects table in which the RealUrl store informations about redirects.

The user has default the access to this module denied but it is possible to allow it with this (user or group)TSconfig:

realUrlManagement.redirects.show =1

Create a new redirect. (The user has default no access to this action but it is possible to grand access with this (user or group) TSconfig: realUrlManagement.redirects.create =1 )

Delete redirect. (The user has default no access to this action but it is possible to grand access with this (user or group) TSconfig: realUrlManagement.redirects.delete =1 )

Clear the Counter. Here you can set the Counter to 0. (The user has default no access to this action but it is possible to grand access with this (user or group) TSconfig: realUrlManagement.redirects.clearCounter =1 )

Edit. You can edit Url, Destination and Moved permanently values. (The user has default no access to this action but it is possible to grand access with this (user or group) TSconfig: realUrlManagement.redirects.edit =1 )

Sort redirects. By clicking on this element the errors will be sorted(ascending or decending) by field right to this element.

Currently selected sorting field. By clicking on this element you switch between ascending and descending sorting.

RealURL-Table Clean¶

With this module you can clear every table used by RealUrl extension to store the URL records. Cleaning of this tables will not affect content or page record. But use this module carefully while by cleaning this tables the RealUrl extension muss create all record newly, and if you have changed name of a page the new generated record for this page will not be the same as the old record and if this page was indexed by e.g. Google the link from Google will not work. But this function is useful if you have finished with development and testing and you want insert real data. Then it can be profitable to clear all old data with this function before you start with inserting of real data.

The user has default the access to this module denied but it is possible to allow it with this (user or group)TSconfig:

realUrlManagement.tableClean.show =1

PageBrowser¶

Pagebrowser is available by modules “Aliases”, ”Errors” and “Redirect”.

You can set this values for pagebrowser:

recordsOnPage

maxPages

realUrlManagement.pageBrowser.{$value}={$number}

realUrlManagement.pageBrowser.{$module}.{$value}={$number}

realUrlManagement.pageBrowser.maxPages=20
realUrlManagement.pageBrowser.aliases.maxPages=20

How to add your own Modules¶

Default this extension contain this modules: Pages, Aliases, Errors, Redirects, RealURL-Table Clean and About. But it is possible to add your own modules. The only thing you must do is to produce an extension with this ext_localconf.php file:

<?php
if (!defined ("TYPO3_MODE"))  die ("Access denied.");
require_once(t3lib_extMgm::extPath('realurlmanagement').'class.tx_realurlmanagement.php');

$myModule['extkey']=$_EXTKEY;
$myModule['script']='pi/class.tx_realurlmanmoduleexample.php';
$myModule['class']='tx_realurlmanmoduleexample';
$myModule['text']='LLL:EXT:'.$_EXTKEY.'/pi/locallang.php:label.example';

tx_realurlmanagement::registerModule($myModule);
?>

The function registerModule take as parameter a array with this values:

realUrlManagement.modules.{extension key}.hide=1

TSconfig configuration¶

This is all available (user or group) TSconfig configuration for this extension

realUrlManagement.pages.show = 1

realUrlManagement.pages.delete = 1

realUrlManagement.pages.deleteShown = 1

realUrlManagement.pages.edit = 1

realUrlManagement.pages.editWholeURL = 1

realUrlManagement.pages.changeExpire = 1

realUrlManagement.pages.expireShown = 1

realUrlManagement.pages.create = 1

realUrlManagement.aliases.show = 1

realUrlManagement.aliases.delete = 1

realUrlManagement.aliases.edit = 1

realUrlManagement.aliases.changeExpire  = 1

realUrlManagement.aliases.create  = 1

realUrlManagement.errors.show = 1

realUrlManagement.errors.delete = 1

realUrlManagement.errors.clearCounter = 1

realUrlManagement.redirects.show = 1

realUrlManagement.redirects.edit = 1

realUrlManagement.redirects.clearCounter = 1

realUrlManagement.redirects.create = 1

realUrlManagement.redirects.delete = 1

realUrlManagement.tableClean.show = 1

realUrlManagement.about.hide = 1

realUrlManagement.pageBrowser.recordsOnPage = 20

realUrlManagement.pageBrowser.maxPages = 20

realUrlManagement.pageBrowser.aliases.recordsOnPage = 20

realUrlManagement.pageBrowser.aliases.maxPages = 20

realUrlManagement.pageBrowser.errors.recordsOnPage = 20

realUrlManagement.pageBrowser.errors.maxPages = 20

realUrlManagement.pageBrowser.redirects.recordsOnPage = 20

realUrlManagement.pageBrowser.redirects.maxPages = 20

realUrlManagement.modules.{extension key}.hide=1