.. You may want to use the usual include line. Uncomment and adjust the path. 
.. include:: ../Includes.txt


===================
EXT: Force RealURLs
===================

:Created:
      2006-04-05T09:44:51

:Changed:
      2008-05-18T12:54:45

:Email:
      julle@typo3.org

:Info 2:


:Info 3:


:Info 4:


.. _EXT-Force-RealURLs:

EXT: Force RealURLs
===================

Extension Key:  **forcerealurls**

Copyright 2008,Christian Jul Jensen, <julle@typo3.org>,
http://mocsystems.com

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.com

.. _Table-of-Contents:

Table of Contents
-----------------

**EXT: mydashboard 1**

**Introduction 1**

What does it do? 1

Screenshots 2

**Users manual 3**

Using the Dashboard 3

**Configuration 4**

Create own Widgets 4

**List of Extensions with Widgets 5**

**Sponsoring mydashboard development 5**

**To-Do list 5**

**Changelog 5**


.. _Introduction:

Introduction
------------


.. _What-does-it-do:

What does it do?
^^^^^^^^^^^^^^^^

This extension forces the access to pages to be made only by the
configured URL-scheme, fx RealURL. It checks the query by which the
site was being accessed and if this is the basic TYPO3 one, ie.
http://mysite/index.php?id=48 or http://mysite/?48 etc, it will
redirect to the appropriate URL.

It will send a HTTP 1.1 301 Redirect header, to tell search engínes
etc that the paged has moved. Thus it can be used when enabling
RealURL on a site that did not previously use it, to keep ranking in
search engines.


.. _Users-manual:

Users manual
^^^^^^^^^^^^

The only thing needed to do is install the extension, no configuration
is needed.


.. _Technical-details:

Technical details
^^^^^^^^^^^^^^^^^

Quite a lot of the TYPO3 FE needs to be initialized before the
information needed to generate the correct URL is available. This
means that the full page is actually generated, and the redirect-
header is only sent right before outputting the content. So the page
will actually be generated twice, which of course gives a performance
overhead, of course the general caching of TYPO3 is still in effect.

In general this is not a big problem as users of the FE are most
likely to use/bookmark the correct URL, but the url used by clicking
the view-icons in the backend uses the “?id” scheme, and so in this
case the page will be generated twice, on the other hand it is nice
for BE-users to see the correct url when pre-viewing their work. It
might make sense to make a configuration of disabling the redirect for
logged in BE-users, or to make the BE use the correct URL directly, to
be used on performance-intensive sites.

The extension will check if RealURL is enabled, and only do the
redirect if so. This is to prevent endless loops. Currently the check
is done explicitly for RealURL, but this is the only RealURL-specific
thing, and check for other URL-extensions can easily be made.


.. _Todo:

**Todo**
^^^^^^^^

- Look into if it is feasible to do the redirect earlier in the FE
  execution to minimize the performance overhead

- Add option for disabling redirect for BE-users

- support other URL-extensions


.. _Thanks:

**Thanks**
^^^^^^^^^^

The development of this extension was fully payed for by Brunata A/S
for use on `http://www.brunata.com <http://www.brunata.com/>`_ .
Brunata is a long time user and supporter of TYPO3. Thank for your
dedication and contributions!

|img-1| EXT: Force RealURLs - 2


.. ######CUTTER_MARK_IMAGES######

.. |img-1| image:: img-1.png
.. :align: left
.. :border: 0
.. :height: 32
.. :id: Graphic1
.. :name: Graphic1
.. :width: 102