DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

EXT: Acqal RealURL Configuration Helper¶

Author:	Kasper Skårhøj
Created:	2002-11-01T00:32:00
Changed:	2009-04-06T15:16:20
Author:	Michael Cannon
Email:	mc@acqal.com
Info 3:
Info 4:

EXT: Acqal RealURL Configuration Helper¶

Extension Key: cbrealurl

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.org

Table of Contents¶

EXT: cbrealurl 1

Introduction 1

What does it do? 1

Screenshots 2

Users manual 2

Adminstration 2

Short Install 2

Install 3

FAQ 4

Configuration 4

Configure for multiple websites 4

Disable RealURL 4

Reference 4

Known problems 5

To-Do list 5

Changelog 5

Introduction¶

What does it do?¶

The Acqal RealURL Extension offers a fast turnkey solution for configuring realurl extension for search engine friendly URLs in minutes! Acqal RealURL uses its own realurl.php file for many popular TYPO3 extensions.
Supported extensions
- tt_news
- news_search
- newloginbox
- indexedsearch
- srfeuserregister
- desimplecalendar
- advCalendar
- nrdfimport
- t3consultancies
- gsislideshow
- tt_products
- piapappnote
- hldamgallery
- irfaq
- skpagecomments
- abdownloads
- ablinklist
- cal
- dmmjobcontrol
- And quite a few singular URL parameters

Screenshots¶

Basic page URL

News-based URL

Users manual¶

No end user operations

Adminstration¶

Short Install¶

Copy _.htaccess to .htaccess in webroot directory
Install realurl, cbrealurl TYPO3 extensions
Include Acqal RealURL static template
Edit config.baseURL in TypoScript
Flush cache
Visit home page

Install¶

Copy _.htaccess to .htaccess in webroot directory
In TYPO3 Extension Manager download and install
- realurl
- cbrealurl
Edit your home page TypoScript template
- In 'Include static' pick 'Acqal RealURL' from right column Items list
Set Base URL
- Change to Constants mode in editing home TypoScript template
- Choose category Basic
- Set 'Base URL' to your website URL
If your website's root page UID if not 1
- Copy EXT:cbrealur/realurl-custom.php to typo3conf/realurl-custom.php
- Set the custom PID if condition to `true`
- Edit realurl-custom.php rootpage_id to your website's root page UID

FAQ¶

SQL to force complete realurl flush¶

TRUNCATE `tx_realurl_chashcache` ;
TRUNCATE `tx_realurl_errorlog` ;
TRUNCATE `tx_realurl_pathcache` ;
TRUNCATE `tx_realurl_redirects` ;
TRUNCATE `tx_realurl_uniqalias` ;
TRUNCATE `tx_realurl_urldecodecache` ;
TRUNCATE `tx_realurl_urlencodecache` ;

Note: Special thanks to Dmitry Dulepov of http://dmitry- dulepov.com for the following warnings when clearing the realurl directly.

TRUNCATE tx_realurl_chashcache -- This should be used only if encode and decode caches are cleared as well. Otherwise, this may cause 404 on pages with news or other items where cHash is necessary. If it does not cause 404s, it will cause pages to be non–cached, which hampers performance.

TRUNCATE tx_realurl_pathcache -- Clearing path cache means that renamed pages will not be accessible by their old name. Normally if the page is renamed, RealURL will create a new entry in the path cache. Old path will redirect to a new path, which is good for SEO. If path cache is cleared, all user bookmarks will go to 404 page and Google will complain in the webmaster's console.

Configuration¶

Configure for multiple websites¶

Copy EXT:cbrealur/realurl-custom.php to typo3conf/realurl-custom.php
Adjust needed single or multiple domain conditions to true
Edit file realurl-custom.php to adjust domain names and rootpage_id

Disable RealURL¶

Change to Constants mode in editing home TypoScript template
Choose category CBREALURL
Disable 'Enable Real URL'

[tsref:(cObject).TEST]

Known problems¶

To be determined

To-Do list¶

To be determined

Changelog¶

2009-04-03 Friday 14:07 cannon

* add redirectOldLinksToNew

2009-04-03 Friday 11:48 cannon

* update CHANGELOG

2009-04-03 Friday 11:45 cannon

* Acqal branding

2009-04-03 Friday 11:34 cannon

* Acqal branding

2009-03-17 Tuesday 01:15 cannon

* update CHANGELOG

2009-03-17 Tuesday 01:15 cannon

* add tx_dmmjobcontrol_pi1[job_uid]

2009-03-16 Monday 13:31 cannon

* add autoUpdate

2009-03-12 Thursday 12:30 cannon

* add multilingual options

2009-03-11 Wednesday 13:45 cannon

* add Powermail 3131 type

2009-03-10 Tuesday 14:19 cannon

* update icon

2009-03-10 Tuesday 14:18 cannon

* update CHANGELOG

2009-03-10 Tuesday 14:18 cannon

* Update manual

2009-03-10 Tuesday 13:57 cannon

* Correct constants path

2009-03-10 Tuesday 13:50 cannon

* update CHANGELOG

2009-03-10 Tuesday 13:50 cannon

* Acqal change

2009-03-10 Tuesday 13:47 cannon

* Inital import of "Acqal_RealURL" directory

2009-03-10 Tuesday 13:24 cannon

* Move "realurl-custom-sample.php" to "realurl-custom.php"

2009-03-03 Tuesday 15:11 cannon

* Post 1.2.0 TER upload

2009-03-03 Tuesday 15:09 cannon

* update CHANGELOG

2009-03-02 Monday 21:25 cannon

* PATH_typo3conf update

2009-01-28 Wednesday 15:00 cannon

* add absolute refernce prefix

2009-01-22 Thursday 02:53 cannon

* remove English language parameter

2009-01-15 Thursday 11:09 cannon

* add expireDays

2009-01-05 Monday 11:13 cannon

* add rating

2008-12-10 Wednesday 19:07 cannon

* indexed search updates

2008-12-07 Sunday 15:34 cannon

* shorter news parameters

2008-08-26 Tuesday 00:29 cannon

* lang set

2008-06-01 Sunday 01:48 cannon

* add ref

2008-05-22 Thursday 06:01 cannon

* multiple domain updates

2008-04-03 Thursday 06:50 cannon

* post 1.1.0 checkin

2008-04-03 Thursday 06:49 cannon

* manual title revision

2008-04-03 Thursday 06:46 cannon

* post 1.0.4 checkin

2008-04-03 Thursday 06:44 cannon

* revise readme to manual

2008-04-03 Thursday 06:44 cannon

* Inital import of "manual.sxw" file

2008-04-03 Thursday 05:26 cannon

* custom var

2008-04-03 Thursday 03:59 cannon

* create own constants pages; drop realurl-custom.php in ext

linking

2008-04-03 Thursday 03:57 cannon

* Move "realurl-custom.php" to "realurl-custom-sample.php"

2007-11-30 Friday 07:26 cannon

* 1.0.3 checkin

2007-11-30 Friday 07:23 cannon

* mod default html and 404 erroring

2007-11-30 Friday 07:16 cannon

* Inital import of "CHANGELOG" file

2007-11-30 Friday 07:15 cannon

* Remoal of "ChangeLog"

2007-11-30 Friday 07:13 cannon

* update realurl to be more like autoconf from realurl; backPid key

2007-11-23 Friday 21:54 cannon

* misc category

2007-11-23 Friday 00:27 cannon

* 1.0.2 checkin

2007-11-23 Friday 00:24 cannon

* README update; realurl conf cleanup

2007-11-22 Thursday 23:54 cannon

* version 1.0.1 checkin

2007-11-22 Thursday 23:48 cannon

* README update, realurl config change, dropping of baseline

rootpage_id

2007-11-22 Thursday 03:28 cannon

* update readme with short install

2007-11-22 Thursday 03:18 cannon

* 1.0.0 check-in

2007-11-22 Thursday 03:15 cannon

* narc/ncat change

2007-11-22 Thursday 03:12 cannon

* Initial cbrealurl TYPO3 extension import

2007-11-22 Thursday 03:12 cannon

* Initial revision

EXT: Acqal RealURL Configuration Helper - 8