.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ==================================== EXT: Readable name of your extension ==================================== :Created: 2010-02-18T17:33:18 :Changed: 2014-09-16T14:36:14.132000000 :Classification: extensionkey :Description: The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ---- :Keywords: keywords comma-separated :Author: Author Name :Email: your@email.com :Info 4: :Language: en |img-1| |img-2| EXT: Redirect Linkhandling - **redirect\_linkhandling** - .. _EXT-Redirect-Linkhandling: EXT: Redirect Linkhandling ========================== Extension Key: redirect\_linkhandling Language: en Keywords: 404 error handling, redirect Copyright 2013, David Mann, 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: Redirect Linkhandling 1 <#__RefHeading__26540_1416263719>`_ **`Introduction 3 <#__RefHeading__26542_1416263719>`_** **`Users manual 4 <#__RefHeading__26552_1416263719>`_** **`Configuration 5 <#__RefHeading__26566_1416263719>`_** **`Known problems 6 <#__RefHeading__26570_1416263719>`_** **`To-Do list 7 <#__RefHeading__26572_1416263719>`_** **`ChangeLog 8 <#__RefHeading__26574_1416263719>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This extension will help you in registering and managing 404 errors. You can configure targets to whose will be redirected while sending a 301 (moved permanently) response header status. It is builded for the purpose of moving whole Websites into a new structure without losing the old links and the ranking of the search services like google. You can also use it to stay informed about sites users are visiting which are leading into an 404 error page. .. _Features: Features """""""" - Supports multidomain environments - different storage pages and typoscript configurations in each domain rootline - stores non handled 404 in the database - lets you configure rules with regular expressions to match against request urls - counts how often an url was requested or a rule matched against the request url - Backend Modul to test urls against the set of rules and links in the database .. _Users-manual: Users manual ------------ .. _Installation: Installation ^^^^^^^^^^^^ Installation is simple. - Install it with the extension manager. - Include the static template in your root template - Configure the two needed TS Values storagePid and errorPage. You can use the constant editor to do so. .. _Usage: Usage ^^^^^ The extension stores every request url which leads into a 404 error in the database once. If it is requested more often it counts the number of requests. You can configure each link in the list module and specify targets or set an ignore flag. |img-3| You can add rules with regular expressions to match against the request url. Those will have a higher priority than the link. |img-4| That means if a rule matches against the request url the extension will not compare the request url with the links-table anymore. In the backend module you can test your rules and links against request urls. .. _Configuration: Configuration ------------- .. _Typoscript-Reference: Typoscript Reference ^^^^^^^^^^^^^^^^^^^^ .. _Constants-module-tx-redirectlinkhandling-persistence-property: Constants (module.tx\_redirectlinkhandling.persistence.[property]) """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .. ### BEGIN~OF~TABLE ### .. _storagePid: storagePid ~~~~~~~~~~ .. container:: table-row Property storagePid Data type String Description Comma separated list of page Ids Default 0 .. ###### END~OF~TABLE ###### .. _Constants-module-tx-redirectlinkhandling-settings-property: Constants (module.tx\_redirectlinkhandling.settings.[property]) """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .. ### BEGIN~OF~TABLE ### .. _pageError: pageError ~~~~~~~~~ .. container:: table-row Property pageError Data type String Description The page id of your 404 error page. Absolute or relative urls are also supported in case you have a static file for your error page. Default 1 .. ###### END~OF~TABLE ###### .. _Example: Example ~~~~~~~ :: module.tx_redirectlinkhandling.persistence.storagePid = 4 module.tx_redirectlinkhandling.settings.errorPage = 2 .. _CLI-Scheduler-Task: CLI Scheduler Task ------------------ .. _Clear-Database: Clear Database ^^^^^^^^^^^^^^ There is a task for the Extbase Command Controller Task which deletes all entries which not have been set to handled after some days. You can configure the number of days after which those entries are deleted and you can set the max number of hits. The intention is that all entries which are hitted only a small amount of times where mistakes which should get deleted frequently to avoid that the database queries take too long after a while. |img-5| .. _Known-problems: Known problems -------------- Please see/report problems in the redirect\_linkhandling project page on `TYPO3 Forge `_ . .. _To-Do-list: To-Do list ---------- A schedular task for sending e-mails to specified administrators with a list of new 404 llinks. – Flexibel response-code, configurable for every link and rule in the backend – statistic tool .. _ChangeLog: ChangeLog --------- .. ### BEGIN~OF~TABLE ### .. _0-1-0: 0.1.0 ^^^^^ .. container:: table-row Version 0.1.0 Changes Added first version, still in alpha mode .. _0-2-0: 0.2.0 ^^^^^ .. container:: table-row Version 0.2.0 Changes Small fixes .. _0-2-1: 0.2.1 ^^^^^ .. container:: table-row Version 0.2.1 Changes Bugfix: Cannot get rootline if template is in separated folder .. ###### END~OF~TABLE ###### |img-2| 9 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 21 .. :hspace: 9 .. :id: Grafik2 .. :name: Grafik2 .. :width: 87 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 248 .. :id: Grafik1 .. :name: Grafik1 .. :width: 669 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 379 .. :id: Grafik3 .. :name: Grafik3 .. :width: 344 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 501 .. :id: Grafik4 .. :name: Grafik4 .. :width: 669