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


=========================
EXT: News Frontend Feeder
=========================

:Author:
      Felix Kiesewetter

:Created:
      2013-12-09T09:08:30

:Changed by:
      Felix Kiesewetter

:Changed:
      2013-12-09T09:42:05

:Classification:
      newsfrontendfeeder

:Keywords:
      tt_news, frontend form, blog, commenting system

:Author:
      Felix Kiesewetter

:Email:
      info@felixkiesewetter.de

:Language:
      en, de, fr, es


.. _img-1-img-2-EXT-News-Frontend-Feeder:

|img-1| |img-2| EXT: News Frontend Feeder
=========================================

Extension Key: newsfrontendfeeder

Languages: en, de, fr, es

Version: 0.2.4

Keywords: tt\_news, blog, commenting system, user input

Copyright 2013, Felix Kiesewetter, <info@felixkiesewetter.de>

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: News Frontend Feeder 1 <#__RefHeading__5708_1738894311>`_**

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

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

`Screenshots 3 <#__RefHeading__12394_267326463>`_

**`Configuration 4 <#__RefHeading__31515_818911409>`_**

`Reference 4 <#__RefHeading__31519_818911409>`_

**`Tutorial 5 <#__RefHeading__31523_818911409>`_**

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

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


.. _Introduction:

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


.. _What-does-it-do:

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

Let your visitors or users write their own tt\_news records on your
website. It's similar to a commenting system, but based on tt\_news,
which makes it easy to generate and style your output – or even
combine it with an already existing tt\_news blog. I have written a
simple `tutorial <#1.3.Tutorial|outline>`_ .

The form has a simple jQuery based validation, you can configure which
fields of the tt\_news db should be used and which should be mandatory
input fields. After the user has filled in the form, it can either be
displayed right away or go through an authorization process. In this
case, an admin gets an email containing the new records content and he
can decide whether he wants to publish the article or delete it from
the database. The user can be informed about his decision.


.. _Screenshots:

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

|img-3|

This is an example of how the form might like. In this case, users can
add articles to an existing blog.


.. _Configuration:

Configuration
-------------


.. _Reference:

Reference
^^^^^^^^^

TypoScript options

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


.. _templateFile:

templateFile
""""""""""""

.. container:: table-row

   Property
         templateFile
   
   Data type
         string
   
   Description
         Change it to use your own template file.
   
   Default
         ::
         
            EXT:newsfrontendfeeder/res/tx_newsfrontendfeeder_pi1.html



.. _useIncludedJQuery:

useIncludedJQuery
"""""""""""""""""

.. container:: table-row

   Property
         useIncludedJQuery
   
   Data type
         boolean
   
   Description
         Use the included jQuery library. Disable this feature if you already
         have jQuery libraries included on your website.
   
   Default
         ::
         
            {$plugin.tx_newsfrontendfeeder.useIncludedJQuery}



.. _result-stdWrap:

result\_stdWrap
"""""""""""""""

.. container:: table-row

   Property
         result\_stdWrap
   
   Data type
         stdWrap
   
   Description
         Configure the result message text freely with TS.
   
   Default
         ::
         
            -



.. _captchaImage-stdWrap:

captchaImage\_stdWrap
"""""""""""""""""""""

.. container:: table-row

   Property
         captchaImage\_stdWrap
   
   Data type
         stdWrap
   
   Description
         Configure the captcha image freely with TS.
   
   Default
         ::
         
            -



.. _CSS-DEFAULT-STYLE:

\_CSS\_DEFAULT\_STYLE
"""""""""""""""""""""

.. container:: table-row

   Property
         \_CSS\_DEFAULT\_STYLE
   
   Data type
         string
   
   Description
         This plugin contains default styles.
   
   Default
         ::
         
            -


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

[tsref:plugin.tx\_newsfrontendfeeder\_pi1.]


.. _Example:

Example
"""""""

Make the result message red and the Captcha background green:

::

     plugin.tx_newsfrontendfeeder_pi1 {
                   result_stdWrap {
                           wrap = <p class="newsfrontendfeeder-result" style=”color: red;”>|</p>
                   }
                   captchaImage_stdWrap {
                           file.backColor = #00FF00
                   }
           }


.. _Tutorial:

Tutorial
--------

Install the extension

On the desired page, include the plugin as content

If you are already using jQuery, go to your TS constants and disable
the usage of the included jQuery library. It is needed for the form's
validation

Configure the Plugin to your liking using the simple Flexform which
should be self-explanatory


.. _Known-problems:

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

None so far.


.. _To-Do-list:

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

Ideas or suggestions? Please feel free to contact me.


.. ######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: 288
.. :id: Grafik1
.. :name: Grafik1
.. :width: 323