realURL2
========

.. toctree::
   :hidden:

   quickstart
   userguide
   domains
   routing
   developers

realURL2 ist ein AddOn, das SallyCMS mit sauberen URLs austattet. Es unterstützt
nativ Kurz-Links, Alternativ-Namen (Slugs) für Artikel sowie die korrekte
Verlinkung zwischen verschiedenen Alias-Domains. Der Code ist auf große Seiten
optimiert und nutzt intelligentes Caching, um eine möglichst hohe Performance zu
erzielen.

realURL2 stellt ebenfalls eine Basis für andere Komponenten bereit, um saubere
URLs zu erzeugen. So können auch andere AddOns recht einfach mit eigenem Routing
aufgestattet werden.

Features
--------

* komplett ID-freie URLs der Form
  ``http://example.com/sprache/kategorie1/kategorie2/artikel.html``
* HTTPS-Unterstützung (erzeugte URLs wechseln nicht das Protokoll)
* vollständige Unterstützung von mehrsprachigen Projekten
* Multi-Domains
* freies Routing von Artikeln und Kategorien
* effizient auch bei großen Seiten

Download, Installation & Nutzung
--------------------------------

Die jeweils aktuelle Version kann online auf `projects.webvariants.de <https://projects.webvariants.de/projects/realurl2/>`_
eingesehen und kostenfrei heruntergeladen werden. Dabei sollte die
`Kompatibilität <http://docs.webvariants.de/downloads.html>`_ geachtet werden.
Ebenfalls benötigt werden die AddOns `Developer Utils <https://projects.webvariants.de/projects/developerutils/>`_
sowie `Global Settings <https://projects.webvariants.de/projects/globalsettings/>`_.

Der Quellcode ist online auf `Bitbucket <http://bitbucket.org/webvariants/realurl2/>`_
verfügbar. Die dort zum Download angebotenen, automatisch generierten Archive
enthalten jedoch nicht die erzeugte Dokumentation.

Weitere Hinweise zur Installation und zur Nutzung sind in eigenen Dokumenten
zu finden:

* Die Installationsanleitung befindet sich auf der :doc:`quickstart`-Seite.
* Das Handbuch ist in einem :doc:`userguide` ausgelagert.

Systemvoraussetzungen
---------------------

* SallyCMS >= 0.6 inkl. der folgenden AddOns:

  * `Developer Utils <https://projects.webvariants.de/projects/developerutils/>`_
  * `Global Settings <https://projects.webvariants.de/projects/globalsettings/>`_

* PHP 5.2
* MySQL 5 mit InnoDB
* Apache mit mod_rewrite

Weitere Informationen
---------------------

* :doc:`quickstart`
* :doc:`userguide`
* :doc:`domains`
* :doc:`routing`
* :doc:`developers`

Kontakt
-------

Sollten Sie einen Fehler finden, können Sie den
`öffentlichen Bugtracker <https://projects.webvariants.de/projects/realurl2/issues/new>`_
verwenden, um ein Ticket zu erstellen und uns darauf aufmerksam zu machen. Bitte
vergessen Sie dabei nicht, die Systeminformationen von der Credits-Seite aus
Sally im Ticket anzugeben.
