.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ======================================= 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: EXT: Acqal RealURL Configuration Helper ======================================= Extension Key: **cbrealurl** Copyright 2000-2009, Michael Cannon, 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: 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: Introduction ------------ .. _What-does-it-do: 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: Screenshots ^^^^^^^^^^^ |img-1| Basic page URL |img-2| News-based URL .. _Users-manual: Users manual ------------ No end user operations .. _Adminstration: Adminstration ------------- .. _Short-Install: 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: 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 - |img-3| - Set Base URL - Change to Constants mode in editing home TypoScript template - Choose category Basic - |img-4| 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 - |img-5| .. _FAQ: FAQ ^^^ .. _SQL-to-force-complete-realurl-flush: 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: Configuration ------------- .. _Configure-for-multiple-websites: 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: Disable RealURL ^^^^^^^^^^^^^^^ - Change to Constants mode in editing home TypoScript template - Choose category CBREALURL - Disable 'Enable Real URL' - |img-6| .. _Reference: Reference ^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. _baseURL: baseURL """"""" .. container:: table-row Property baseURL Data type string Description Base URL:Example: http://example.com Default .. _tx-realurl-enable: tx\_realurl\_enable """"""""""""""""""" .. container:: table-row Property tx\_realurl\_enable Data type boolean Description Enable Real URL:Un-enable simulateStaticDocuments if enabled Default 1 .. _simulateStaticDocuments: simulateStaticDocuments """"""""""""""""""""""" .. container:: table-row Property simulateStaticDocuments Data type boolean Description ISimulate Static Documents:Un-enable if using Real URL Default 0 .. _no-cache: no\_cache """"""""" .. container:: table-row Property no\_cache Data type boolean Description No Cache Default 0 .. _prefixLocalAnchors: prefixLocalAnchors """""""""""""""""" .. container:: table-row Property prefixLocalAnchors Data type string Description Prefix Local Anchors:If set to one of the keywords, the content will have all local anchors in links prefixed with the path of the script. Default all .. _absRefPrefix: absRefPrefix """""""""""" .. container:: table-row Property absRefPrefix Data type string Description Absolute Reference Prefix: For multiple domain must use /. Otherwise / or same as config.baseURL. Default / .. ###### END~OF~TABLE ###### [tsref:(cObject).TEST] .. _Known-problems: Known problems -------------- To be determined .. _To-Do-list: To-Do list ---------- To be determined .. _Changelog: 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 |img-7| .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 252 .. :id: graphics2 .. :name: graphics2 .. :width: 669 .. |img-2| image:: img-2.jpeg .. :align: left .. :border: 0 .. :height: 351 .. :id: graphics3 .. :name: graphics3 .. :width: 669 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 222 .. :id: graphics4 .. :name: graphics4 .. :width: 621 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 447 .. :id: graphics5 .. :name: graphics5 .. :width: 540 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 104 .. :id: graphics7 .. :name: graphics7 .. :width: 621 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 453 .. :id: graphics6 .. :name: graphics6 .. :width: 645 .. |img-7| image:: img-7.png .. :align: left .. :border: 0 .. :height: 29 .. :id: graphics1 .. :name: graphics1 .. :width: 105