.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ========================= EXT: Abile Personal Notes ========================= :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed: 2004-11-15T12:43:51 :Author: Author Name :Email: your@email.com :Info 3: :Info 4: .. _EXT-Abile-Personal-Notes: EXT: Abile Personal Notes ========================= Extension Key: **abile\_notes** Copyright 2000-2002, David Worms, 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.com .. _Table-of-Contents: Table of Contents ----------------- **EXT: Abile Personal Notes 1** **Introduction 1** What does it do? 1 Screenshots 1 **Users manual 3** FAQ 3 **Adminstration 3** FAQ 3 **Configuration 3** FAQ 4 Reference 4 **Tutorial 5** **Known problems 5** **To-Do list 5** **Changelog 5** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ - Abile Notes extension allows frontend users to write and edit personal notes. This extension is targeted toward intranet applications. - In the frontend, the frontend users can create new notes, edit and delete his notes. If correctly set in the backend, they can view the notes of others frontend users as well. - In the backend, the backend users can create, edit and delete all the notes as long as they owns the correct permissions. They can as well assign read and edit/delete permissions for a particular note to more than one users. - This extension was donated by the company `Abile.net `_ . .. _Screenshots: Screenshots ^^^^^^^^^^^ Frontend: .. ### BEGIN~OF~TABLE ### .. _img-1: |img-1| """"""" .. container:: table-row a |img-1| b |img-2| .. ###### END~OF~TABLE ###### Backend .. ### BEGIN~OF~TABLE ### .. ###### END~OF~TABLE ###### .. _Users-manual: Users manual ------------ - The extension is meant to be used in an intranet environment. Your visitors must be authenticated before accessing this extension as it references a frontend user entity. Otherwise, the notes will be accessible to everyones (not tested but should behave much like a combinaison of a small wiki-guestbook). - Frontend users can search, read and edit their notes. From the backend, a permission system may allow the sharing of notes. Also, a note may be tagged as “active” - The extension is made of two frontend plugins. - The “Abile Personal Notes” plugin is the central piece. By default, the extension looks like divided in two main parts. The top section provide a listing of notes. The bottom section may vary depending on the context and is related to a specific note. After cliking on a note title in the top section, an information screen will be displayed in the bottom section. This is also the default behavior when you arrive on a page holding this extension. In the latter case, the last updated note is displayed. From the information screen, more information are displayed and you can choose to edit or delete a note if you have the correct permissions. - The “Abile Active Notes” plugin provides a listing of the last updated active notes. .. _FAQ: FAQ ^^^ none at the moment .. _Adminstration: Adminstration ------------- - The notes are stored as a note elements inside a page. You could for exemple create a “Notes” page and set it as a System Folder. Once you insert the frontend plugin into one of your site page, you just reference the later System Folder. - When you create a note from the backend, you'll be ask for the title, the content, the read permissions and the write permissions. The title and the content fields are self explanatory. The read permissions and the write permissions must point to existing frontend users. If more than one frontend users is assigned to a note, then this note will be shared across those users. .. _FAQ: FAQ ^^^ Please post your questions and we'll put them in the FAQ one after the others. .. _Configuration: Configuration ------------- - Installing the Abile Notes extension should be an easy task. From the extension manager, go to “Import extensions from online repository” and enter the key “abile\_notes”. The extension will be registered as a frontend plugin. To insert it in a page content, create a new content in the page you want the extension to be, create a new content, select its type to “External plugin” and select the plugin as “Abile Notes”. Next is to define the page in which the notes will be stored. Set the “Startingpoint” to this page. - You can insert the extension from your template Tsconfig. This method present the advantage of having the extension available on every single page. To do so, the minimum required is to set the notesPid property to the page storing your note. The is achieve with the follogin code: :: #my page id is 49: plugin.tx_abilenotes_pi1 { notesPid = 49 } lib.rightColumn < plugin.tx_abilenotes_pi1 - You may control the display of the extension. This is achieved by overwriting the default TSconfig properties, overwriting the stylesheet or unseting the current one, and providing your own templates. Exemples of how you can overwrite the Tsconfig are presented in the Reference page. - Default Stylesheet: The default stylesheet is located in the files “ext\_typoscript\_setup.txt”. You can unset the stylesheet and set your own with the follogin code in your TSconfig: :: #unset the stylesheet plugin.tx_abilenotes_pi1._CSS_DEFAULT_STYLE > #set personal stylesheet page.includeCSS { file1 = path/to/my/style.css } - Templates The extension makes use of the Smarty template engine. This is a geat way to seprate the logic from the display. Furthermore, it aims at helping you to develop your very own templates. In order to so so, you must configure the location of the directory were you will prepare the templates. This is achieve through the “templatesDir” property. In this directory, you must create to new directories called “templates” and “templates\_c”. In the new “templates” directory, you must insert the three templates “editScreen.tpl”, “listScreen.tpl” and “viewScreen.tpl”. The “templates\_c” directory is used by Smarty as a cache folder and must be writable. You'll find the default templates at the root of the Abile Notes extension. .. _FAQ: FAQ ^^^ Please post your questions and we'll put them in the FAQ one after the others. .. _Reference: Reference ^^^^^^^^^ \- Possible subsections: Reference (TypoScript) .. ### BEGIN~OF~TABLE ### .. _allInOnePage: allInOnePage """""""""""" .. container:: table-row Property allInOnePage Data type boolean Description Wether or not we should display the list screen on top of every screens Default 1 .. _templatesDir: templatesDir """""""""""" .. container:: table-row Property templatesDir Data type string Description Location of the template and template\_c Smarty templates Default .. _notesPid: notesPid """""""" .. container:: table-row Property notesPid Data type integer Description The page used to store the notes Default .. _listView-results-at-a-time: listView.results\_at\_a\_time """"""""""""""""""""""""""""" .. container:: table-row Property listView.results\_at\_a\_time Data type integer Description Number of results to display Default 5 .. _listView-maxPages: listView.maxPages """"""""""""""""" .. container:: table-row Property listView.maxPages Data type integer Description Number of pages to browse from. An odd value will be better displayed. Default 5 .. _listView-searchFieldList: listView.searchFieldList """""""""""""""""""""""" .. container:: table-row Property listView.searchFieldList Data type string Description The indexed fields to search from Default content,title .. _listView-orderByList: listView.orderByList """""""""""""""""""" .. container:: table-row Property listView.orderByList Data type string Description The database columns ordering the list Default tstamp,title .. ###### END~OF~TABLE ###### [tsref:tx\_abilenotes\_pi1] .. ### BEGIN~OF~TABLE ### .. _templatesDir: templatesDir """""""""""" .. container:: table-row Property templatesDir Data type string Description Location of the template and template\_c Smarty templates Default .. _listView-results-at-a-time: listView.results\_at\_a\_time """"""""""""""""""""""""""""" .. container:: table-row Property listView.results\_at\_a\_time Data type integer Description Number of results to display Default 5 .. _listView-orderByList: listView.orderByList """""""""""""""""""" .. container:: table-row Property listView.orderByList Data type string Description The database columns ordering the list Default tstamp,title .. ###### END~OF~TABLE ###### [tsref:tx\_abilenotes\_pi2] .. _generated: ((generated)) """"""""""""" .. _Minimum-example: Minimum example ~~~~~~~~~~~~~~~ :: #my page id is 49: plugin.tx_abilenotes_pi1 { notesPid = 49 } lib.rightColumn < plugin.tx_abilenotes_pi1 .. _Full-exemple: Full exemple ~~~~~~~~~~~~ :: plugin.tx_abilenotes_pi1{ #top screen is the list, bottom screen is the note details allInOnePage = 1 #number of results to display listView.results_at_a_time = 4 #number of pages to browse from listView.maxPages = 5 #the indexed fields to search from listView.searchFieldList = content,title #the database columns ordering the list listView.orderByList = tstamp,title #location of the template and template_c Smarty templates templatesDir = } .. _Tutorial: Tutorial -------- The extension should be intuitive and easy enough to use. There are not so many possible actions. .. _Known-problems: Known problems -------------- Please give us a maximum of feedback (good and bad). Also, we encourage you to provide us new translations. .. _To-Do-list: To-Do list ---------- - Translate the extension in as many language as possible - Correct the spelling and the grammar. - Provide a new property to determine wether or not a new user should have edit permissions by default as it is now the case. - Add the possiblility to assign others others or groups from the front end to enable notes sharing. - Allows categorisation of message. .. _Changelog: Changelog --------- - October 29 2004: orgininal posting. - November 15 2004: correct a few bug, add “active” functionnalities and plugin. |img-5| EXT: Abile Personal Notes - 5 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 396 .. :id: Graphic4 .. :name: Graphic4 .. :width: 226 .. |img-2| image:: img-2.png .. :align: left .. :border: 0 .. :height: 425 .. :id: Graphic5 .. :name: Graphic5 .. :width: 226 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 182 .. :id: Graphic6 .. :name: Graphic6 .. :width: 334 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 322 .. :id: Graphic7 .. :name: Graphic7 .. :width: 334 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102