Metadata-Version: 2.0
Name: odoo10-addon-website-seo-redirection
Version: 10.0.1.0.0.99.dev1
Summary: Redirect any controller to the URL of your dreams
Home-page: https://tecnativa.com/
Author: Tecnativa, LasLabs, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
License: LGPL-3
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 2.7
Classifier: Framework :: Odoo
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Requires-Dist: odoo (<10.1dev,>=10.0)

.. image:: https://img.shields.io/badge/licence-LGPL--3-blue.svg
   :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
   :alt: License: LGPL-3

=======================
Website SEO Redirection
=======================

This module extends the functionality of the website to support using custom
URLs and allow you to improve the SEO.

Usage
=====

Moving a page to another URL
----------------------------

Let's assume you created a blog post entry that is absolutely amazing and you
want a fixed and beautiful URL for it. That entry is posted in
``https://example.com/blog/our-news-1/post/amazing-post-23``, but you want it
at ``https://example.com/amazing``. You need to:

#. Go to *Website Admin > SEO Redirections > Create*.
#. Set ``/blog/our-news-1/post/amazing-post-23`` as *Original URL*.
#. Set ``/amazing`` as *Destination URL*.
#. Enable *Relocate controller*.

Now navigate to any of both URLs, and you will get to the blog post, but with
the URL you wanted.

Setting a URL as a redirection to another one
---------------------------------------------

Let's assume you created a blog post entry that is absolutely amazing and you
want a shortened URL that redirects to it. That entry is posted in
``https://example.com/blog/our-news-1/post/amazing-post-23``, but you want that
``https://example.com/amazing`` redirects to it. You need to:

#. Go to *Settings > Configuration > SEO Redirections > Create*.
#. Set ``/amazing`` as *Original URL*.
#. Set ``/blog/our-news-1/post/amazing-post-23`` as *Destination URL*.
#. Disable *Relocate controller*.

Now navigate to any of both URLs, and you will get to the blog post, with its
original URL untouched.


.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
   :alt: Try me on Runbot
   :target: https://runbot.odoo-community.org/runbot/186/10.0

Known issues / Roadmap
======================

* Redirections are cached. If you hit one once, and then change it, you will
  mostly have to clear your browser's cache to avoid hitting a 404 error.
* Make it multiwebsite-compatible.

Notes for migration to v10:

* `#4146 <https://github.com/odoo/odoo/issues/4146>`_ was fixed, so we could
  make the *Promote* panel load data from an extended ``website.seo.metadata``
  class.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues
<https://github.com/OCA/website/issues>`_. In case of trouble, please
check there if your issue has already been reported. If you spotted it first,
help us smashing it by providing a detailed and welcomed feedback.

Credits
=======

Images
------

* Odoo Community Association: `Icon <https://github.com/OCA/maintainer-tools/blob/master/template/module/static/description/icon.svg>`_.

Contributors
------------

* Jairo Llopis <jairo.llopis@tecnativa.com>
* Dave Lasley <dave@laslabs.com>

Maintainer
----------

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

To contribute to this module, please visit https://odoo-community.org.


