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


======================
EXT: HTTP/HTTPS Switch
======================

:Author:
      Christopher

:Created:
      2010-12-18T19:57:23

:Changed by:
      Claude Borgogno

:Changed:
      2013-09-17T01:08:53

:Classification:
      ax_https

:Keywords:
      forAdmins, forIntermediates, http, https, pages

:Author:
      Claude Borgogno

:Email:
      axoide@axoide.com

:Language:
      en


.. _img-1-img-2-EXT-HTTP-HTTPS-Switch:

|img-1| |img-2| EXT: HTTP/HTTPS Switch
======================================

Extension Key: ax\_https

Language: en

Version: 0.2.0

Keywords: forAdmins, forIntermediates, http, https, pages

Copyright 2013, Claude Borgogno, <axoide@axoide.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.org

.. _Table-of-Contents:

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

**`EXT: HTTP/HTTPS Switch 1 <#__RefHeading__5708_1738894311>`_**

**`Introduction 3 <#__RefHeading__5710_1738894311>`_**

`What does it do? 3 <#__RefHeading__463_413120346>`_

`Screenshots 3 <#__RefHeading__465_413120346>`_

**`Users manual 4 <#__RefHeading__467_413120346>`_**

`Installation 4 <#__RefHeading__31507_818911409>`_

**`Known problems 6 <#__RefHeading__31525_818911409>`_**

**`To-Do list 7 <#__RefHeading__477_413120346>`_**

**`ChangeLog 8 <#__RefHeading__31623_818911409>`_**


.. _Introduction:

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


.. _What-does-it-do:

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

This extension lets you decide if your TYPO3 pages should be displayed
with an HTTPS or HTTP scheme. The extension is compatible with
RealURL, and can be used as well for a single page or for complete
site sections.

This extension does the same job as the extension "HTTPS Enforcer /
macmade.net" (https\_macmade) but is built with Extbase and Fluid. The
extension depends on TYPO3 6.1.


.. _Screenshots:

Screenshots
^^^^^^^^^^^

Here you see what the extension does:

|img-3|


.. _Users-manual:

Users manual
------------


.. _Installation:

Installation
^^^^^^^^^^^^

The installation of this extension is very simple. Just connect to the
Typo3 Extension Repository and download «HTTP/HTTPS Switch»
(ax\_https).

You'll then need to include the static TS template in your main TS
template, like in the picture below:

|img-4|

You will also need to call the HTTPS Switch plugin in the page object
of your main template, like this:

::

   page = PAGE
   page.5 < lib.tx_axhttps
   page.10 = FLUIDTEMPLATE

Note that you do not have to use FluidTemplate. The extension is also
compatible with TemplaVoila and the old templating system.

For CSS stylesheets and other links, you must also set
"config.baseURL" conditionally this way:

::

   [page|tx_axhttps_protocol = 1][globalVar = LIT:1 = {$plugin.tx_axhttps.settings.mode}]
     config.baseURL = https://www.mydomain.net/
   [else]
     config.baseURL = http://www.mydomain.net/
   [global]

Once it's done, you'll be able to configure the default behavior. This
is done through the TS constant editor. You can do that on your main
template, or in extension templates, if you want a different behavior
for a site section, for instance.

|img-5|

Then, if you edit the headers of a page, you'll notice a new field.
This will configure the HTTP scheme for that single page:

|img-6|

Now let's take a look at some configurations.

If you've enforced your website with an HTTPS scheme, every page will
be displayed under HTTPS unless they are configured to use HTTP.

If you don't set the enforce mode globally, the settings from each
page will be taken. But in that case, if you visit an HTTPS enforced
page, and then a page that is not enforced, neither HTTPS or HTTP,
you'll stay with an HTTPS scheme.

In that way, you should be able to achieve the most complex
configurations for your website.


.. _Known-problems:

Known problems
--------------

None at the time. Just contact me if you find some.


.. _To-Do-list:

To-Do list
----------

Please contact me if you have suggestions for this extension.


.. _ChangeLog:

ChangeLog
---------

.. ### BEGIN~OF~TABLE ###


.. _0-2-0:

0.2.0
^^^^^

.. container:: table-row

   Version
         0.2.0
   
   Changes
         \- The field "protocol" added to the table "pages" has been renamed as
         "tx\_axhttps\_protocol".
         
         (Consider running the update script in the extension manager)
         
         \- Fixed bug "No template was found"



.. _0-1-0:

0.1.0
^^^^^

.. container:: table-row

   Version
         0.1.0
   
   Changes
         First public release


.. ###### END~OF~TABLE ######


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

.. |img-1| image:: img-1.png
.. :align: left
.. :border: 0
.. :height: 44
.. :id: graphics5
.. :name: graphics5
.. :vspace: 57
.. :width: 161

.. |img-2| image:: img-2.png
.. :align: left

.. |img-3| image:: img-3.png
.. :align: bottom
.. :border: 0
.. :height: 226
.. :id: images1
.. :name: images1
.. :width: 631

.. |img-4| image:: img-4.png
.. :align: bottom
.. :border: 0
.. :height: 273
.. :id: images2
.. :name: images2
.. :width: 631

.. |img-5| image:: img-5.png
.. :align: bottom
.. :border: 0
.. :height: 354
.. :id: images3
.. :name: images3
.. :width: 313

.. |img-6| image:: img-6.png
.. :align: bottom
.. :border: 0
.. :height: 226
.. :id: images4
.. :name: images4
.. :width: 631