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


==========================
EXT: Modern FAQ – A-Z list
==========================

:Author:
      Kasper Skårhøj

:Created:
      2002-11-01T00:32:00

:Changed by:
      Rik Willems

:Changed:
      2009-06-15T09:56:10.400000000

:Classification:
      irfaq_az

:Keywords:
      modern, faq, a-z, alphabetic, list

:Author:
      Rik Willems

:Email:
      http://www.actiview.nl

:Info 4:


:Language:
      en


|img-1| |img-2| EXT: Modern FAQ – A-Z list - irfaq\_az


.. _EXT-Modern-FAQ-A-Z-list:

EXT: Modern FAQ – A-Z list
==========================

Extension Key: irfaq\_az

Language: en

Keywords: modern, faq, a-z, alphabetic, list

Copyright 2000-2008, Rik Willems, <http://www.actiview.nl>

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: Modern FAQ – A-Z list 1
<#1.EXT:%20Modern%20FAQ%20%E2%80%93%20A-Z%20list|outline>`_

**`Introduction 3 <#1.1.Introduction|outline>`_**

`What does it do? 3 <#1.1.1.What%20does%20it%20do_|outline>`_

`Screenshots 3 <#1.1.2.Screenshots|outline>`_

**`Users manual 5 <#1.2.Users%20manual|outline>`_**

`Configuration 5 <#1.2.1.Configuration|outline>`_

`Reference 5 <#1.2.2.Reference|outline>`_

`Known problems 5 <#1.2.3.Known%20problems|outline>`_

`To-Do list 5 <#1.2.4.To-Do%20list|outline>`_

**`ChangeLog 6 <#1.3.ChangeLog|outline>`_**


.. _Introduction:

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


.. _What-does-it-do:

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

This extension extends irfaq and provides a new frontend plugin that
creates an A-Z list. The words for the A-Z list are selected from the
irfaq question table. This view is based on the 'dynamic' view or
irfaq. All features that irfaq provides (answered by, etc) are also
available in this extension.

For each letter in the alphabet a header is created, if that letter
corresponds to the first letter of a word in the A-Z list. Through the
setup a site's administrator can choose how may columns the A-Z list
should have.


.. _Screenshots:

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


.. _Two-column-A-Z-list:

Two column A-Z list
"""""""""""""""""""


.. _img-3:

|img-3|
"""""""


.. _Three-column-A-Z-list:

Three column A-Z list
"""""""""""""""""""""

|img-4|


.. _Users-manual:

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


.. _How-to-install-and-setup:

How to install and setup
^^^^^^^^^^^^^^^^^^^^^^^^

- Install irfaq extensions like described in manual.
  
  Include static (from extension): 'IRFAQ default TS (irfaq)'

- Install irfaq\_az extension
  
  Include static (from extension): 'Modern FAQ – A-Z list (irfaq\_az)'

- Create FAQ items like described in the irfaq manual.

- Add a new content element of type 'insert plugin' and select plugin
  'Modern FAQ – A-Z list' and choose a startingpoint, where you saved
  the created FAQ items.


.. _Configuration:

Configuration
^^^^^^^^^^^^^

You can use normal irfaq constants and setup for configuration (see
manual), but use plugin.tx\_irfaqaz\_pi1.


.. _Reference:

Reference
^^^^^^^^^

This extension adds one property:

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


.. _numberOfColumns:

numberOfColumns
"""""""""""""""

.. container:: table-row

   Property
         numberOfColumns
   
   Data type
         int
   
   Description
         Assigns the number of columns the A-Z list will generate.
   
   Default
         1


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

[tsref:plugin.tx\_irfaqaz\_pi1


.. _Known-problems:

Known problems
^^^^^^^^^^^^^^

None at the moment.


.. _To-Do-list:

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

- Creating a Flexform that allows selection of categories.

- Allow numberOfColumns to be selected from Flexform

- Any suggestions for improvement are welcome.


.. _ChangeLog:

ChangeLog
---------

- v. 1.0.0, private development

- v. 2.0.0, April 7 :sup:`th` 2009, first release to TER

- v. 2.0.1, April 9 :sup:`th` 2009, improvements based on suggestion on
  mailinglist.

- v. 2.0.2, June 15 :sup:`th` 2009
  
  Removed $this->cObj->enableFields('tx\_irfaq\_q') from fillMarkers()
  where query.This function is already called through
  exec\_getQuery(...) so it has no use and creates a larger query.Thanks
  to Jochem Nabuurs of Roquin E-Solutions for noticing and sending me an
  email.

6


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

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

.. |img-2| image:: img-2.png
.. :border: 0
.. :height: 21
.. :hspace: 9
.. :id: Grafik2
.. :name: Grafik2
.. :width: 87

.. |img-3| image:: img-3.png
.. :align: left
.. :border: 0
.. :height: 524
.. :id: Afbeeldingen1
.. :name: Afbeeldingen1
.. :width: 669

.. |img-4| image:: img-4.png
.. :align: left
.. :border: 0
.. :height: 524
.. :id: Afbeeldingen2
.. :name: Afbeeldingen2
.. :width: 669