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


===========
Twitter it!
===========

:Author:
      E L

:Created:
      2009-03-30T15:37:28

:Changed by:
      Eberhard Loh

:Changed:
      2010-09-21T12:07:02.530000000

:Author:
      Eberhard Loh

:Email:
      eloh@zellwerk.com

:Info 3:
      Zellwerk GmbH & Co. KG

:Info 4:
      www.zellwerk.com


|img-1| |img-2| Twitter it!

­


.. _Twitter-it:

Twitter it!
===========

Extension Key:  **zw\_twitterit**

Copyright 2000-2010, Eberhard Loh, <eloh@zellwerk.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
-----------------

`Twitter it! 1 <#1.Twitter%20it!|outline>`_

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

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

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

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

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

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

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

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

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

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

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

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


.. _Introduction:

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


.. _What-does-it-do:

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

- This extension is a pure backend hook function which is involved with
  each new/edit/save page or content..

- It tweets the title, description and a link to pages with specific
  PIDs if not already done (a flag “twittered” is set).

- Configuration easily done in the extension manager.


.. _What-does-it-not-do:

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

It does not  **recursively** search pages in the tree, just first-
level subpages of given UIDs.


.. _Screenshots:

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

- Backend view:
  
  |img-3|

- Frontend View:
  
  |img-4|


.. _Users-manual:

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

How to install:

- look for the UID of the page(s) containing the articles to be tweeted.

- install the extension

- got to `http://dev.twitter.com/apps/new
  <http://dev.twitter.com/apps/new>`_ , log in with the account you are
  going to use for the extension
  
  - …
  
  - Application Website:
    `http://typo3.org/extensions/repository/view/zw\_twitterit/current/
    <http://typo3.org/extensions/repository/view/zw_twitterit/current/>`_
  
  - Application Type: (\*) Browser
  
  - Default Access type: (\*) Read & Write
  
  - …

- copy “Consumer key” and “Consumer Secret” into the corresponding
  fields in the extension config in ext manager

- continue with “My Access Token”

- copy “Access Token (oauth\_token)” and “Access Token Secret
  (oauth\_token\_secret)” into the config

- check and set other required parameters (page-id, ...).

- From this time every new/untwittered page (under the container-
  page(s)) will be sent to twitter whenever a page or content is saved.
  (The saving is just the trigger, no matter, which pages ist touched)


.. _FAQ:

FAQ
^^^

- Q: will recursive scanning from the container page become implemented?

- A: maybe soon...


.. _Troubleshooting:

Troubleshooting
^^^^^^^^^^^^^^^

- Check all Tokens/Keys, copy them again from the dev.twitter website.

- Enable debugging. Responses from twitter.com will be written to the
  extension dir. Search these for error messages.


.. _Administration:

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

Installation should be straightforward. No more configuration except
these above.


.. _Configuration:

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

As described above.


.. _Known-problems:

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

none


.. _To-Do-list:

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

- Recursive scanning of pages

- configurable format of tweets

- ???


.. _ChangeLog:

ChangeLog
---------

- 1.0.0: Initial release to TER

- 1.1.0: switched to oAuth using Abraham Williams `http://abrah.am
  <http://abrah.am/>`_ twitteroauth.php

10


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

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

.. |img-2| image:: img-2.png
.. :border: 0
.. :height: 23
.. :id: Grafik2
.. :name: Grafik2
.. :width: 86

.. |img-3| image:: img-3.png
.. :align: left
.. :border: 0
.. :height: 634
.. :id: Grafik1
.. :name: Grafik1
.. :width: 436

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