.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

.. include:: ../../../Includes.txt

ListSubEntries
^^^^^^^^^^^^^^

This one lists entries from another table. It's easier to explain with an example: You are displaying page entries and want to show the names of content elements on that page -- this is how you do that.

sDatabase
---------

String. If the database differs from dbal/sDatabase, enter it here.

sTable
------

String. Table name of the table to list entries from. Following our page-contentelement-example: ::

    tt_content

sTableColumn
------------

String. The other end of the relation. Connect the column/field on which this callback is performed with this sTableColumn in the foreign table (sTable). The example would consist of the pages' *uid* column on which this callback would be performed. sTableColumn would in that case be set to ::

    pid

sTableColumnShow
----------------

String. Column within sTable that is shown as list. ::

    header

sTableOrderBy
-------------

String. If you want to order alphabetically, you may set that here: ::

    header ASC

aTableWhere
-----------

Array. Set various where parts here if you need to: ::

    aTableWhere = array(
      'deleted:0',
      'hidden:0'
    )

sTableWhere
-----------

String. Just as dbal/sWhereGet you could set another where part freely here: ::

    sTableWhere = uid IN (123, 456, 789)

sFieldHandlerClassReplacement
-----------------------------

String. In case your column handler mix your output up, replace the default aField class handler here. Example: ::

    TextShort

sConcatenate
------------

String. This is the connector between single items. For a comma-list, enter a comma here. We want to output an unordered list, though, thus we leave this one empty.

sWrap
-----

String. Maybe you want to surround the whole output with something. Just keep in mind to include the pipe sign (|). Example: ::

    <ul>|</ul>

sWrapSingle
-----------

String. Every single entry gets wrapped here: ::

    <li>|</li>


Of course, as always, you might want to use markers here: ::

    <li><a href="?id=123&uid=###uid###">|</a></li>