#. \ |image0|\ TUW Informations

   Extension Key: tuw\_informations

   Language: en

   Version: 0.7.62

   Keywords: TU Wien, TISS, Adressbuch, Publikationen, Projekte

   Copyright 2006-2017, Heinz A. Krebs, <heinz@chemit.at>, Krebs Inc.

   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

   `TUW Informations 1 <#__RefHeading__5708_1738894311>`__

   `Introduction 3 <#__RefHeading__5710_1738894311>`__

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

   `Getting started 4 <#__RefHeading__467_413120346>`__

   `Install extension 4 <#__RefHeading__31507_818911409>`__

   `Notify me about your installation
   4 <#__RefHeading__932_844671900>`__

   `Create Page Content 5 <#__RefHeading__6565_94905253>`__

   `Include the static template 5 <#__RefHeading__984_1761644690>`__

   `Available Frontend-plugins 6 <#__RefHeading__986_1761644690>`__

   `TUW Stafflist 6 <#__RefHeading__988_1761644690>`__

   `TUW Projects 8 <#__RefHeading__990_1761644690>`__

   `TUW Publicationslist 8 <#__RefHeading__992_1761644690>`__

   `Synchronize the database regulary
   9 <#__RefHeading__3880_1162667831>`__

   `Known problems 10 <#__RefHeading__934_844671900>`__

   `To-Do list 10 <#__RefHeading__938_844671900>`__

   `FAQ 10 <#__RefHeading__31509_818911409>`__

   #. 

   #. Introduction

      #. What does it do?

         #. The *tuw\_informations* extension supplies 4 plugins to
                display information copied from the TISS (TU Wien
                Informations-Systeme & Services). To speed up the
                processing of the various lists all data is not
                requested directly from TISS, but copied from TISS to
                the local TYPO3-database either upon a call by the
                backend user or regulary via a cronjob/task.

                Currently 4 different frontend-plugins are available:

1. **TUW Stafflist** – displays the list of employees of an organisation
   unit (institute) or even only for divisions. The list can be
   displayed as alphabetical list, or grouped by their function
   (according to TISS), or grouped by their scientific status
   (professors, diploma students, etc).

2. **TUW Staffheader** – displays contact information for one employee
   including a picture.

3. **TUW Projects** – displays all running projects of an organisation
   unit.

4. **TUW Publications** – displays all publications of an organisation
   unit or for a single division. The list can be restricted to show
   only some publication types (e.g. Just papers and lectures)

   #. 

   #. Getting started

      #. Install extension

         #. First you need to install the tuw\_informations extension.
                Since this extension is not available via the TER (TYPO3
                Extension Repository) you need to download the extension
                from the developer's website at
                http://krebs.chemit.at/index.php?id=1261 . After this
                you can upload the extension to your TYPO3 environment
                using the extension manager.

                To do so, go to the extension manager and click on the
                icon in the upper left corner (“Upload extension
                .t3x/.zip”). Depending on your configuration (Version
                4.7 or 6.0) you will presented a dialog box to upload
                the extension (4.7) or you can find an input field on
                the upper right corner (6.0). In any case please select
                the.t3x-file you have downloaded before and upload it to
                the TYPO3-server. If you're already using the extension
                and you want to upload an updated version please do not
                forget to tick the checkbox near “Overwrite already
                existing extension”.

                After a successful upload you should find the extension
                in the list like below.

                |image1|

                There is no need to configure the extension, you can now
                start using the frontend-plugins.

                If you want to update the database regulary you need to
                configure a task. See the section `Synchronize the
                database regulary <#__RefHeading__3880_1162667831>`__
                how to setup that task.

         Notify me about your installation

         #. Since the extension is not available via the TER you are not
                able to automatically update it when a new version is
                available.

                This is the reason why i would like to ask you to send
                me you contact email-address, so in case of a new
                release i can drop you a note.

      Create Page Content

      #. Include the static template

         #. The extension uses predefined stylesheets for the layout of
                the page content. To use these formatting you need to
                include a static template in all pages you are using the
                plugins. You can do this at the root of your website or
                create an extension template to the pages you are using
                the plugins.

                Click on the “template” menu item in the TYPO3 navigator
                and select the page you want to extend. Click on “create
                an extension template” (if none exists):

                |image2|

                On the page “Template Tools” click on the pencil near
                “Edit the whole template record”:

                |image3|

                Go to the tab named “Includes”. In the section “Include
                static (from extension)” and scroll down in the list of
                available items until you can find the entry “TUW
                Informations CSS (tuw\_informations)” and click on that
                item.

                |image4|

                Save the document to have now all CSS-declarations
                included. If you want do declare your own CSS-statements
                for this plugin please see the appendix, which selectors
                the plugin uses.

         Available Frontend-plugins

         #. 4 different frontend-plugins are available to display needed
                informations. In any case you need to create a new
                content element of the type “General Plugin”. On the tab
                Plugin you then have the possibility to select the
                plugin you want to use.

         TUW Stafflist

         #. Select the plugin from the list of available plugins:

                |image5|

                After this you will be presented the configuration
                options for this plugin:

                You have |image6|\ access to the following
                administrative settings:

-  **Organisationseinheit**: select the organisational unit for which
   you would like to list the employees. Right to the listbox you can
   see a button “Synchronize now”. If you click on this button the list
   of employees of the selected organisational unit will be synchronized
   from the TISS to the local database. Please be aware that this might
   take some seconds, since one XML-file for earch employee must be
   fetched from TISS and parsed. This function should only be used once
   to populate the database on the first use of an organisational unit
   or on “emergency updates”, since it's better to synchronize the
   database regulary by using a cronjob/task.

-  **Interner Code**: optional value if you are using the “interner
   code”-field from TISS. (Please contact the author for details, how
   the institute E163 is using this option).

-  **Standardmässig folgende Liste anzeigen**: select how the list of
   employees should be sorted by default (by family name, function or
   scientific status).

-  **Seite mit Personal nach Funktion anzeigen**: if you would like to
   show a link to sort the employees by their function (according to
   TISS) please tick this checkbox.

-  **Seite mit Personal nach Nachnamen sortiert anzeigen**: if you would
   like to show a link to sort the employees by their family name please
   tick this checkbox.

-  **Seite mit Personal nach wissenschaftlichen Status anzeigen**: if
   you would like to show a link to sort the employees by their
   scientific status please tick this checkbox. (Please not that this is
   only possible, if you are using the “Internal code”-field for
   employees in TISS)

-  **Darstellungsart**: select which layout you want to use for your
   list.

-  **Priorisiere folgende Mitarbeiter**: if you would like to put some
   employees on top of the list of staff, you can enter them here with
   their OID and the function separated by a colon, more than one
   employees are separated by a blank. E.g. If you would like to list
   employee 933593 as head of division and 856112 as office you have to
   enter “933593:Head of division,856112:Secretary” - Option is buggy!

-  **Folgende Kategorien nicht anzeigen**: if you would like to hide
   some emplyees please select here the functions groups which you would
   like to hide – Option is buggy

   #. After you have fully configured the plugin please save your
          settings.

   #. TUW Projects

      #. The following settings are available:

             |image7|

             In the listbox “Organisationseinheit” you can select the
             organisational unit for which you would like to display the
             currently running projects. To update the database click on
             the “Synchronize now”-button on the right to the listbox.

      TUW Publicationslist

      #. This frontend-plugin can be configured by the following
             parameters:

-  | |image8|\ **Organisationseinheit** – the organisational unit you
     would like to display publications for. Upon the first use of this
     plugin (for a given unit) you need to synchronize the database with
     the information from the publication database. To do so please
     click on the “Synchronize now” button on the right hand to the
     listbox.
   | This step has to be performed as well if you do not setup a regular
     task to synchronize the local database.

-  **Abteilung** – the division of the organisational unit (if
   available)

-  **Publikationen anzeigen seit** – if you want to show only the latest
   publications please select here the year of the oldest publication to
   show.

-  **Publikationstyp** – you need to select at least one publication
   type which should be shown on the webpage.

-  **Layout** – please select the layout of the plugin you would like to
   use for displaying your data

-  **“Zusätzliche Informationen” ausblenden** – sometimes citates have a
   link to the publication database with further information for this
   publication. If you would like to hide this link please tick this
   checkbox

-  **Links in Referenzen entfernen** – sometimes a citate includes some
   links to external resources (doi, ..). If you would like to hide
   these links please tick the checkbox.

   #. Synchronize the database regulary

      #. If you want to keep the local database updated you need to run
             a sheduled task. TYPO3 has the possibility to run
             reoccuring task.

             Select the Scheduler from the Admin Tools in the
             TYPO3-Navigation and list the scheduled tasks.

          |image9|

      #. Click on the Plus-Icon in the left upper corner to add a new
             task.

          |image10|

      #. From the list of available classes select the TISS Sync-task.
             The type of the task should be sent to Recurring. In the
             frequency field you need to specify the interval in seconds
             how often the task should be executed. I suggest to run
             this task once a day (or less) so the frequency should be
             set to 86400. Save the task.

             You will need to setup a cronjob as well. Open a console on
             your TYPO3-webserver as admin and add the following line to
             your cronjobs:

             0 \* \* \* \*
             /path/to/your/typo3/installation/typo3/cli\_dispatch.phpsh
             scheduler

             Please be aware that only data from organizations will be
             imported if at least one content element with that
             organization has been created. That means that if you have
             not configured one of the plugins at all, then nothing will
             be imported!

             If you add a plugin and configure it for your institution
             no data will be displayed until:

      -  The scheduler runs the next time

      -  You start a synchronization by hand, using the Sync-Icon
         |image11| on the plugin administration page.

      Known problems

      #. Currently none reported.

      To-Do list

      #. None

             Please do not hesitate to contact me at heinz@chemit.at if
             you have a wishlist or usefull patches. You may also reach
             me by phone within the TUphone by dialing my extension
             163649 (Monday-Wednesday 9am – 2pm).

      FAQ

      #. None

.. |image0| image:: media/image1.png
   :width: 1.67431in
   :height: 0.46250in
.. |image1| image:: media/image4.png
   :width: 5.64583in
   :height: 1.44792in
.. |image2| image:: media/image6.png
   :width: 3.48403in
   :height: 2.07639in
.. |image3| image:: media/image7.png
   :width: 3.48403in
   :height: 1.87847in
.. |image4| image:: media/image8.png
   :width: 3.48403in
   :height: 2.12153in
.. |image5| image:: media/image9.png
   :width: 4.19792in
   :height: 1.57292in
.. |image6| image:: media/image10.png
   :width: 4.59931in
   :height: 6.52569in
.. |image7| image:: media/image11.png
   :width: 3.48403in
   :height: 1.89306in
.. |image8| image:: media/image12.png
   :width: 3.48403in
   :height: 3.47569in
.. |image9| image:: media/image13.png
   :width: 3.48403in
   :height: 1.31806in
.. |image10| image:: media/image14.png
   :width: 3.48403in
   :height: 1.74722in
.. |image11| image:: media/image15.png
   :width: 0.16667in
   :height: 0.16667in
