.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ============ EXT: div2007 ============ :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed: 2008-04-27T13:30:48 :Author: Elmar Hinz :Email: elmar.hinz@team-red.net :Info 3: :Info 4: .. _EXT-div2007: EXT: div2007 ============ Extension Key: **div2007** Copyright 2007-2008, Elmar Hinz, 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: div 1** **The functions of tx\_div in alphabetic order 1** autoLoadAll 1 browserSession 1 clearAllCaches 2 db 2 explode 2 findTce 2 getDataBase 2 getFrontEndUser 3 getSiteRelativeExtensionPath 3 getValidKey 3 guessKey 3 getGlobal 3 load 3 loadClass 3 loadTcaAdditions 4 makeInstance 4 makeInstanceClassName 4 resolvePathWithExtPrefix 4 session 4 tce 4 toHashArray 5 toHashObject 5 toHashString 5 toListArray 5 toListObject 5 toListString 5 user 5 userSession 5 .. _The-functions-of-tx-div-2007-in-alphabetic-order: The functions of *tx\_div* 2007 in alphabetic order ---------------------------------------------------- .. _autoLoadAll: autoLoadAll ^^^^^^^^^^^ .. _Definition: Definition """""""""" This function walks through all directories of an extension and includes all class files it finds. .. _Comment: Comment """"""" This is rather a quick and dirty solution for lazy file inclusion. There are drawbacks. Please see sourcecode comments before you use it. .. _browserSession: browserSession ^^^^^^^^^^^^^^ .. _Definition: Definition """""""""" Store data into the browser session or load it from there. .. _Comment: Comment """"""" The browser session lasts, while the browser is opened, by default with a maximum of 24 hours. Also see *tx\_div2007::userSession()* and *tx\_div2007::session()* . .. _clearAllCaches: clearAllCaches ^^^^^^^^^^^^^^ .. _Definition: Definition """""""""" Clear all caches at once. .. _Comment: Comment """"""" This function if for the development process only. It can be applied temporary to avoid repeated cache clearing by hand. It will be painful for you, if you forget to disable it on your live server. .. _db: db ^^ .. _Definition: Definition """""""""" This is an alias for the function *tx\_div2007::getDataBase()* . .. _explode: explode ^^^^^^^ .. _Definition: Definition """""""""" Explode a string to an array in a typical way. .. _Comment: Comment """"""" This is typically used to simplify user input for example by TypoScript. Strings are exploded by *,;:* comma, semicolon and colon. The resulting tokens are trimmed. Whitespace inside the token is kept. The list of names: *David Copperfield, Mr. Wickfield, Uriah Heep* would be split into 3 tokens. .. _findTce: findTce ^^^^^^^ .. _Definition: Definition """""""""" Get an instance of the TCE. .. _Comment: Comment """"""" Use the features of the TCE also from the frontend. Useful to do INSERT and UPDATE queries in full accordance with the T3 constraints, but not very fast. A backend user must be logged in or be faked. .. _getDataBase: getDataBase ^^^^^^^^^^^ .. _Definition: Definition """""""""" Get the global TYPO3\_DB object. .. _Comment: Comment """"""" Typically used to do SELECT queries. .. _getFrontEndUser: getFrontEndUser ^^^^^^^^^^^^^^^ .. _Definition: Definition """""""""" Get the global frontend user object. .. _getSiteRelativeExtensionPath: getSiteRelativeExtensionPath ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. _Definition: Definition """""""""" Load the site relative extension path for the given extension key. .. _Comment: Comment """"""" That is the path to the extension from the view point of the browser in opposite to the absolute path from the view point of the server file system. .. _getValidKey: getValidKey ^^^^^^^^^^^ .. _Definition: Definition """""""""" Takes the extension key with or without underscores and finds the matching official extension key with underscores. If the extension key is not loaded it returns false. .. _Comment: Comment """"""" Helps you to find the real, valid key, if you only know the key with underscores stripped. The stripped key is i.e. part of class names. .. _guessKey: guessKey ^^^^^^^^ .. _Definition: Definition """""""""" Takes a string like a class name or a file path, that contains any information about the extension key, and tries to extract it in the official format with underscores. .. _getGlobal: getGlobal ^^^^^^^^^ .. _Definition: Definition """""""""" Get the global variable of the given key. .. _load: load ^^^^ .. _Definition: Definition """""""""" This is an alias for the function *tx\_div2007::loadClass()* . .. _loadClass: loadClass ^^^^^^^^^ .. _Definition: Definition """""""""" Find and include the file for the given class name 'tx\_key\_path\_file'. .. _loadTcaAdditions: loadTcaAdditions ^^^^^^^^^^^^^^^^ .. _Definition: Definition """""""""" Loads TCA additions of other extensions .. _Comment: Comment """"""" Your extension may depend on fields that are added by other extensions. For reasons of performance parts of the TCA are only loaded on demand. To ensure that the extended TCA is loaded for the extensions yours depends on you can apply this function. .. _makeInstance: makeInstance ^^^^^^^^^^^^ .. _Definition: Definition """""""""" Load the class file and make an instance of the class. .. _Comment: Comment """"""" This is an extension to t3lib\_div::makeInstance(). It automatically finds and includes the required class file. The XCLASS mechanisms are working. See *tx\_div2007::makeInstanceClassName()* . .. _makeInstanceClassName: makeInstanceClassName ^^^^^^^^^^^^^^^^^^^^^ .. _Definition: Definition """""""""" Load the class file and return the class name or the ux\_classname. .. _Comment: Comment """"""" See *tx\_div2007::makeInstance()* . .. _resolvePathWithExtPrefix: resolvePathWithExtPrefix ^^^^^^^^^^^^^^^^^^^^^^^^ .. _Definition: Definition """""""""" Resolve extension paths that make use of the "EXT:" prefix. .. _Comment: Comment """"""" The path is relative to PATH\_site. See *tx\_div2007::getSiteRelativeExtensionPath()* . .. _session: session ^^^^^^^ .. _Definition: Definition """""""""" This is an alias for the function *tx\_div2007::browserSession()* . .. _tce: tce ^^^ .. _Definition: Definition """""""""" This is an alias for the function *tx\_div2007::findTce()* . .. _toHashArray: toHashArray ^^^^^^^^^^^ .. _Definition: Definition """""""""" Takes suitable data as input and converts it to a hash array. .. _toHashObject: toHashObject ^^^^^^^^^^^^ .. _Definition: Definition """""""""" Takes suitable data as input and converts it to a hash object. .. _toHashString: toHashString ^^^^^^^^^^^^ .. _Definition: Definition """""""""" Takes suitable data as input and converts it to a hash string. .. _toListArray: toListArray ^^^^^^^^^^^ .. _Definition: Definition """""""""" Takes suitable data as input and converts it to a list array. .. _toListObject: toListObject ^^^^^^^^^^^^ .. _Definition: Definition """""""""" Takes suitable data as input and converts it to a list object. .. _toListString: toListString ^^^^^^^^^^^^ .. _Definition: Definition """""""""" Takes suitable data as input and converts it to a list string. .. _user: user ^^^^ .. _Definition: Definition """""""""" This is an alias for the function *tx\_div2007::getFrontEndUser()* . .. _userSession: userSession ^^^^^^^^^^^ .. _Definition: Definition """""""""" Store data into the user session or load it from there. .. _Comment: Comment """"""" The user session is bound to the user account. If a frontend user logs into the same account on a different machine, the session data is already there. Also see *tx\_div2007::browserSession()* . |img-1| EXT: div2007 - 5 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102