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


===================
EXT: Twitter Search
===================

:Author:
      Kasper Skårhøj

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

:Changed by:
      Thomas Löffler

:Changed:
      2010-03-01T11:15:13

:Classification:
      twitter_search

:Description:
      The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ----

:Keywords:
      twitter search atom hash

:Author:
      Thomas Loeffler

:Email:
      typo3@tomalo.de

:Info 4:


:Language:
      en


|img-1| |img-2| EXT: Twitter Search - twitter\_search


.. _EXT-Twitter-Search:

EXT: Twitter Search
===================

Extension Key: twitter\_search

Language: en

Keywords: twitter search atom hash

Copyright 2000-2008, Thomas Loeffler, <typo3@tomalo.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: Twitter Search 1 <#1.EXT:%20Twitter%20Search|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.3.Users%20manual|outline>`_**

**`Administration 6 <#1.4.Administration|outline>`_**

**`Configuration 7 <#1.5.Configuration|outline>`_**

**`Known problems 8 <#1.6.Known%20problems|outline>`_**

**`To-Do list 9 <#1.7.To-Do%20list|outline>`_**

**`ChangeLog 10 <#1.8.ChangeLog|outline>`_**


.. _Introduction:

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


.. _What-does-it-do:

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

- This extension gives you the last “Tweets” of a specific topic you can
  configure in the plugin.

- For information about “Twitter” please visit: `http://www.twitter.com
  <http://www.twitter.com/>`_


.. _Screenshots:

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

|img-3|

|img-4|


.. _Live-Examples:

Live Examples
^^^^^^^^^^^^^

Munich TYPO3 Usergroup: `http://www.mtug.de/twitter/
<http://www.mtug.de/twitter/>`_

You are welcome to send me another examples at typo3@tomalo.de.


.. _Users-manual:

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

- Just import the extension from the TER and install it.

- Insert a plugin on a page of your choice and configure the search
  within the plugin

- With the operator selectors you can select if it is a AND or an OR
  search. (e.g. 'typo3 and kasper' shows different results like 'typo3
  or kasper')

- You can search for words, hash tags or/and users plus selecting the
  result language

- For an advanced search you can manage your own very specific search on
  `http://search.twitter.com/advanced
  <http://search.twitter.com/advanced>`_ and paste the search url into
  the plugin.

- Because of activated caching you have to set a caching period on the
  page where the plugin is implemented (see screenshot)

|img-5|


.. _Administration:

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

This extension supports english and german language.


.. _Configuration:

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

No complex configuration needed


.. _Reference:

Reference
^^^^^^^^^

Possible subsections: Reference (TypoScript)

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


.. _templatefile:

templatefile
""""""""""""

.. container:: table-row

   Property
         templatefile
   
   Data type
         string
   
   Description
         Location for the template file
   
   Default
         EXT:twitter\_search/res/templates/list.html



.. _format:

format
""""""

.. container:: table-row

   Property
         format
   
   Data type
         string
   
   Description
         “atom” or “json” (supported in future)
   
   Default
         “atom”


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


.. _generated:

((generated))
"""""""""""""

.. _Example:

Example
~~~~~~~

Here you would show an example of the stuff from the reference or so:

::

   plugin.tx_twittersearch_pi1 {
       templatefile = fileadmin/templates/twitter_search.html
       format = atom
   }


.. _Known-problems:

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

- None

- please contact me at `typo3@tomalo.de <mailto:typo3@tomalo.de>`_ if
  you find any issues


.. _To-Do-list:

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

- Import into table (e.g. tt\_news)

- Support for JSON format

- “Reply”, “follow” and “retweet” links in every tweet


.. _ChangeLog:

ChangeLog
---------

See Changelog.txt in Extension

11


.. ######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: 568
.. :id: Grafik1
.. :name: Grafik1
.. :width: 669

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

.. |img-5| image:: img-5.png
.. :align: left
.. :border: 0
.. :height: 111
.. :id: Grafik4
.. :name: Grafik4
.. :width: 353