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


================
EXT: Custom Home
================

:Author:
      Christopher

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

:Changed:
      2013-07-09T17:13:50.510000000

:Classification:
      custom_home

:Keywords:
      frontend, dragable, sortable

:Author:
      arieedzig

:Email:
      arieedzig@yahoo.com

:Language:
      en


.. _img-1-img-2-EXT-Custom-Home:

|img-1| |img-2| EXT: Custom Home
================================

Extension Key: custom\_home

Language: en

Version: 0.0.1

Keywords: frontend, dragable, sortable

Copyright 2013, arieedzig, <arieedzig@yahoo.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: Custom Home 1 <#__RefHeading__5708_1738894311>`_**

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

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

`How does it works? 3 <#__RefHeading__5860_1443339195>`_

`Screenshots 3 <#__RefHeading__465_413120346>`_

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

**`Administration 6 <#__RefHeading__31511_818911409>`_**

`Install the Extension 6 <#__RefHeading__6024_1443339195>`_

`Hideable navigation 6 <#__RefHeading__31513_818911409>`_

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

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


.. _Introduction:

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


.. _What-does-it-do:

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

This extension creates configurable content layout by the frontend
user. The frontend user can arrange the layout of the content by drag
and drop it to the desired position. The position will be saved in
browser cookie or database when the user login. The layout will be
restored whenever the cookie exist or user has been logged in.

This extension is useful to give user ability to define own layout for
the content of a page, so that user can put more important content
based on their preferences.


.. _How-does-it-works:

How does it works?
^^^^^^^^^^^^^^^^^^

The extension generatesdrag and drop-able content element on the
frontend and uses jquery and ajax to make the content element position
and state can be saved in cookieordatabase.


.. _Screenshots:

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

Inserting the extension:

|img-3| Lists of configurable content elements:

|img-4| Frontend Output1:

|img-5| Frontend Output 2:

|img-6| 
Users manual
------------

User will only need to drag and drop the content element to the
desired position, hide and unhide the content they need. The state
will be saved to the cookie or when the user logged in, it will be
saved in database.


.. _Administration:

Administration
--------------


.. _Install-the-Extension:

Install the Extension
^^^^^^^^^^^^^^^^^^^^^

Download the newest Extension using the Extension Manager/Extension
Repository.

Install the Extension using the Extension Manager.

Add the Extension on the desired page.

|img-3| Define the default column and content elements that should be appeared
on the page.


.. _Hideable-navigation:

Hideable navigation
^^^^^^^^^^^^^^^^^^^

When the main column have a width limitation, we can add the following
typoscript on the setup section of the page template to make a
hideable navigation and extend the width of the main column, this
example applies to the page with Template Auto-Parser. In this
example, the main column is defined in left\_nav object:

::

   page.10.subparts {
     left_nav.wrap = <div id="nav1" class="nav"><div class="nav-btn"><img width="16" height="16" alt="Info" title="Info" src="../typo3/sysext/t3skin/icons/module_web_list.gif"></div> | </div>
   } 

The div above will be processed by jquery so that it will be hidden by
default, we can hover on the icon to make it visible, and then we can
access the navigation.


.. _Known-problems:

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

None.


.. _ChangeLog:

ChangeLog
---------

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


.. _0-0-1:

0.0.1
^^^^^

.. container:: table-row

   Version
         0.0.1
   
   Changes
         Initial version.


.. ###### 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: left
.. :border: 0
.. :height: 32
.. :id: graphics6
.. :name: graphics6
.. :width: 227

.. |img-4| image:: img-4.png
.. :align: left
.. :border: 0
.. :height: 378
.. :id: graphics8
.. :name: graphics8
.. :width: 329

.. |img-5| image:: img-5.png
.. :align: left
.. :border: 0
.. :height: 351
.. :id: graphics1
.. :name: graphics1
.. :width: 472

.. |img-6| image:: img-6.png
.. :align: left
.. :border: 0
.. :height: 406
.. :id: graphics7
.. :name: graphics7
.. :width: 429