.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ================ EXT: tm\_topapps ================ :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: Tapio Markula :Changed: 2008-04-08T18:20:22 :Author: Tapio Markula :Email: tapio.markula@xetpoint.fi :Info 3: :Info 4: .. _EXT-tm-topapps: EXT: tm\_topapps ================ Extension Key: **tm\_topapps** Copyright 2000-2007,Tapio Markula, < `tapio.markula@xetpoint.fi `_ > `Stefan Galinski `_ 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: tm\_topapps 1** **Introduction 1** What does it do? 1 History 1 **Configuration 2** TS Config for users/ user groups 2 Other configurations 2 **Hooks 2** **Known Problems 3** General 3 Unimplemented Features of the Original topapps 3 Open Issues 4 **Changelog 4** **Credits 5** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This is just a version of *Kasper's* and *Lasse's* 'topapps', which was in *'Typo3 4.1.0 beta'* . That plugin added two function bars to the top of the backend, for example drag'drop modulemenu and clear cache functionalities. Topapps was intended as an alternative for traditional backend for Typo3 4.1 and newer, but it was not implemented in Typo3 4.1 series. *Typo3 4.2* has similar functionalities on the top of the view and the new backend replaced the topapps. Tm\_topapps has some unimplemented features regarding the original topapps, but implemented features are stable. Concerning *Typo3 4.1* tm\_toppapps adds most of the functionalities of topapps and some new functionalities. The only part, which can be used with Typo3 4.2 is alternative module menu. The plugin *'tm\_shared lib'* adds an option in order to choose the module menu type. If extended personal user setup has been enabled, it is possible to change menu type also from *'User > Setup'* module. Tm\_topapps adds also a new interface option, which can be added with the install too ( *'backend\_topapps'* ) .. _History: History ^^^^^^^ This plugin was previously a part of *'tm\_shared\_lib'* . For Typo3 4.2 the plugin has been changed so, that the module menu can be use as alternative of the left side menu. .. _Configuration: Configuration ------------- .. _TS-Config-for-users-user-groups: TS Config for users/ user groups ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ This plugin has following shared configuration for user TS configuration user/user group *mod.SHARED* : .. ### BEGIN~OF~TABLE ### .. ###### END~OF~TABLE ###### Generic TS Config for users using setup.override: .. ### BEGIN~OF~TABLE ### .. _allowChangeUser: allowChangeUser """"""""""""""" .. container:: table-row Property allowChangeUser Datatype boolean Description Allows using topapps non-administrators to change user from the user menu. If not enabled the whole module is disabled because personal user setup can do also from elsewhere, if the user setup is in generally allowed. **Only for Typo3 4.1.** Default 0 .. ###### END~OF~TABLE ###### This plugin has following configuration for user TS configuration user/user group for new alternative of the plugin *'toppapps'* using *mod.topapps* : .. ### BEGIN~OF~TABLE ### .. _disableBasicShortcuts: disableBasicShortcuts """"""""""""""""""""" .. container:: table-row Property disableBasicShortcuts Datatype boolean Description Disables the default shortcut icon set of Kasper's topapps. Default 0 .. _companyImage: companyImage """""""""""" .. container:: table-row Property companyImage Datatype string Description Possible to define web address for the logo image of some company. **Only for Typo3 4.1.** Default .. _companyAddress: companyAddress """""""""""""" .. container:: table-row Property companyAddress Datatype string Description Possible to define web address link for the related company logo. **Only for Typo3 4.1.** Default .. _hideButtonToolbar: hideButtonToolbar """"""""""""""""" .. container:: table-row Property hideButtonToolbar Datatype boolean Description Hides second row topapps (big shortcut icons, the tab set for submodules of the ' *Web'* main module. **Only for Typo3 4.1.** Default 0 .. ###### END~OF~TABLE ###### .. _Other-configurations: Other configurations ^^^^^^^^^^^^^^^^^^^^ With the install tool it is possible to add interface *'backend\_toppapps',* which temporary takes use the drag'n drop menu instead of leftside menu. In the configuration of tm\_shared\_lib (first implementation in ver. *'0.2.8'* ) has been added for Typo3 4.2 option to use the main menu from tm\_topapps ( *'backendmenutype'* ). .. _Hooks: Hooks ----- Added in the middle of module installation a hook to add new modules. $TYPO3\_CONF\_VARS['EXTCONF'][TM\_TOPAPPS\_EXTkey]['addTopApps'] **Note.** The function *'addTopApps'* must have a parameter. The value must be used to check, if the module will be added among other modules, for example (use the same folder name and module name): function *addTopApps* ($moduleName) { if($moduleName=='my1module') t3lib\_extMgm::addTopApp('xMOD\_txtopapps\_my1module',t3lib\_extMgm::e xtPath($\_EXTKEY).'my1module/'); if($moduleName=='my2module') t3lib\_extMgm::addTopApp('xMOD\_txtopapps\_my2module',t3lib\_extMgm::e xtPath($\_EXTKEY).'my2module/'); } I made a hook for the logo menu on the top left corner in order to reset the entire menu. $TYPO3\_CONF\_VARS['EXTCONF'][TM\_TOPAPPS\_EXTkey]['logoMenuItems'] Modules *'xMOD\_txtopapps\_dashboard'* and *'xMOD\_txtopapps\_search'* didn't work. I made possible to make hooks for them and create with them proper functionalities. $TYPO3\_CONF\_VARS['EXTCONF'][TM\_TOPAPPS\_EXTkey]['addDasboardItems'] Just return with the function *'addDasboardItem* ' a string. $TYPO3\_CONF\_VARS['EXTCONF'][TM\_TOPAPPS\_EXTkey]['addSearchMenuItems '] Just return with the function *'addSearchMenuItems* ' a string. $TYPO3\_CONF\_VARS['EXTCONF'][TM\_TOPAPPS\_EXTkey]['addSearchBox'] Just do needed database operations and echo needed string. To the second row, where is some shortcut links added by the module *'xMOD\_txtopapps\_shortcuts',* you can add any new link $TYPO3\_CONF\_VARS['EXTCONF'][TM\_TOPAPPS\_EXTkey]['addShortcutItems'] Just return with the function *'addShortcutItems'* string. **Note.** All hooks work only with Typo3 4.1. .. _Known-Problems: Known Problems -------------- .. _General: General ^^^^^^^ Works with all features only with Typo3 4.1.x. .. _Unimplemented-Features-of-the-Original-topapps: Unimplemented Features of the Original topapps ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - submenu for direct access to module functionalities - dashboard module (possible to build using a hook) - search module (possible to build using a hook) Below comparison table between original topapps, tm\_topapps and Typo3 4.2 .. ### BEGIN~OF~TABLE ### .. _Unknown-Property: ((Unknown Property)) """""""""""""""""""" .. container:: table-row a topapps topapps tm\_topapps tm\_topapps Typo 4.2 Typo 4.2 .. _Logo-menu: Logo menu """"""""" .. container:: table-row a Logo menu topapps X tm\_topapps X Typo 4.2 .. _Drop-down-module-menu: Drop down module menu """"""""""""""""""""" .. container:: table-row a Drop down module menu topapps X tm\_topapps X Typo 4.2 .. _Drop-down-menu-with-submenu: Drop down menu with submenu """"""""""""""""""""""""""" .. container:: table-row a Drop down menu with submenu topapps X (not functional) tm\_topapps Typo 4.2 .. _Cache-menu: Cache menu """""""""" .. container:: table-row a Cache menu topapps X tm\_topapps X Typo 4.2 X .. _Clock: Clock """"" .. container:: table-row a Clock topapps X tm\_topapps X Typo 4.2 .. _Shortcut-bar: Shortcut bar """""""""""" .. container:: table-row a Shortcut bar topapps X tm\_topapps X Typo 4.2 .. _Submodules-Web-modules: Submodules (Web modules) """""""""""""""""""""""" .. container:: table-row a Submodules (Web modules) topapps X \* tm\_topapps X Typo 4.2 .. _Old-shortcuts-and-old-search: Old shortcuts and old search """""""""""""""""""""""""""" .. container:: table-row a Old shortcuts and old search topapps tm\_topapps X Typo 4.2 .. _Shortcut-menu: Shortcut menu """"""""""""" .. container:: table-row a Shortcut menu topapps tm\_topapps Typo 4.2 X .. _Dashboard: Dashboard """"""""" .. container:: table-row a Dashboard topapps X (not functional) tm\_topapps (possible to build)\*\* Typo 4.2 .. _User-menu: User menu """"""""" .. container:: table-row a User menu topapps X tm\_topapps X Typo 4.2 X .. _Workspace-selector: Workspace selector """""""""""""""""" .. container:: table-row a Workspace selector topapps tm\_topapps Typo 4.2 X .. _Link-to-workspace-module: Link to workspace module """""""""""""""""""""""" .. container:: table-row a Link to workspace module topapps tm\_topapps Typo 4.2 X .. _Workspace-menu: Workspace menu """""""""""""" .. container:: table-row a Workspace menu topapps X tm\_topapps X Typo 4.2 .. _Company-logo: Company logo """""""""""" .. container:: table-row a Company logo topapps X tm\_topapps X Typo 4.2 .. _Search: Search """""" .. container:: table-row a Search topapps X (not functional) tm\_topapps (possible to build) Typo 4.2 X .. _User-information: User information """""""""""""""" .. container:: table-row a User information topapps tm\_topapps Typo 4.2 X .. _Logout-link: Logout link """"""""""" .. container:: table-row a Logout link topapps \*\*\* tm\_topapps X\*\*\*\* Typo 4.2 X .. ###### END~OF~TABLE ###### \*Web submodules are in the same row as some shortcuts to certain modules. \*\* There is hook in the module in order to build the functionality \*\*\* Logout link is Icon menu. \*\*\*\* Logout link is an icon .. _Open-Issues: Open Issues ^^^^^^^^^^^ There is however a problem, which relates with the replacement of the plugin *'topapps'. Some* browsers have z-index problems. Frame documents inside the content might have SELECT-boxes, which goes over dropdown menus. Because the content is inside nested frameset and not in the same page, it is not possible to hide SELECT-boxes with some additional JavaScript code. If you want to avoid problem just use a browser, which doesn't have z-index problem, which relates with this issue. Concerning MS IE this problem has been fixed in IE 7. Another problems relates with special characters in the UTF-8 backend interface. Add into locallang.php a line: *ini\_set('default\_charset', 'UTF-8');* Internet Explorer 6 has some small glitches, but nothing critical. Firefox 2.x, IE 7 and Opera 9.x works like expected. Konqueror has some problems with frames and the submenus. Its not possible to use the menu reasonable with that browser. Browser below the mentioned versions can work, but that wasnt tested. .. _Changelog: Changelog --------- - Made Typo3 4.2 compatible. - Added so-called JavaDoc descriptions before functions. - Some code improvements and performance work; Added browser in the user module; Changed look of the old\_shortcuts module to an icon at the right site; Bugfixes (Thanks to Stefan Galinski) - Fixed a bug in contextual menus, if new menu styles has been used (the bug was actually in tm\_shared lib and I changed only required version number). - Moved all 'tm\_topapps' related JavaScript and CSS into this plugin. - Made topapps related extensions as as a new extension. Note that key names of hooks has been changed. Related changes, when this plugin was a part of tm\_shared\_lib: - Added new module 'logout' – stand alone log out link on the first row. - Changed a little bit hook handling. - Added multilingual language labels to the modified version of the plugin 'topapps'. - Added integrated support for 'topapps' plugin (the plugin comes from *Typo3 4.1 RC 1* ) with some these changes: - Disabled possibility to change big shortcut icons. - Disable as default the module 'user' from non-administrators. - Made hook for shortcut links (allows to put changing of icons back). - Disabled function menus from dropdown menus because they don't work. - Normal shortcuts implemented as IFRAME inside a layer, which can be show and hide. Workspace selector has been take off because it is in top right. - Disabled new search functionality, because it didn't work (search is available in the shortcut frame). Made hook for trying to recreate it. - Disable example dashboard but make possible to create it using a hook. - Possible to disable second toolbar row setting *'mod.topapps.hideButtonToolbar=1'.* - Some images are skin image instead of fixed image names. - Dummy company logo disabled. Company logo needs *'mod.topapps.companyAddress=...'* and *'mod.topapps.companyImage=...'.* .. _Credits: Credits ------- Special thank's for *Stefan Galinski* < `Stefan.Galinski@frm2.tum.de `_ > helping finding and fixing bugs, creating a module for topapps and some improvements. Ext: tm\_topapps - 5 |img-1| .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 19 .. :id: Grafiikka5 .. :name: Grafiikka5 .. :width: 75