Translation2
[ class tree: Translation2 ] [ index: Translation2 ] [ all elements ]
Packages:
Translation2


Classes:
Translation2
Translation2_Admin
Translation2_Admin_Container_dataobjectsimple
Translation2_Admin_Container_db
Translation2_Admin_Container_gettext
Translation2_Admin_Container_mdb
Translation2_Admin_Container_mdb2
Translation2_Admin_Container_xml
Translation2_Admin_Decorator
Translation2_Admin_Decorator_Autoadd
Translation2_Container
Translation2_Container_dataobjectsimple
Translation2_Container_db
Translation2_Container_gettext
Translation2_Container_mdb
Translation2_Container_mdb2
Translation2_Container_xml
Translation2_Decorator
Translation2_Decorator_CacheLiteFunction
Translation2_Decorator_CacheMemory
Translation2_Decorator_DefaultText
Translation2_Decorator_ErrorText
Translation2_Decorator_Iconv
Translation2_Decorator_Lang
Translation2_Decorator_SpecialChars
Translation2_Decorator_UTF8
Files:
Admin.php
admin_containers_tests.php
admin_db_test.php
admin_gettext_po_test.php
admin_mdb2_test.php
admin_mdb_test.php
admin_xml_test.php
all_tests.php
Autoadd.php
CacheLiteFunction.php
CacheMemory.php
Container.php
containers_tests.php
dataobjectsimple.php
dataobjectsimple.php
db.php
db.php
dbms.php
db_test.php
Decorator.php
Decorator.php
DefaultText.php
ErrorText.php
gettext.php
gettext.php
gettext_admin.php
gettext_mo_test.php
gettext_po_test.php
gettext_prepare.php
gettext_prepare.php
gettext_settings.php
Iconv.php
Lang.php
mdb.php
mdb.php
mdb2.php
mdb2.php
mdb2_test.php
mdb_test.php
settings.php
simple_include.php
SpecialChars.php
t2xmlchk.php
Translation2.php
translation2_admin_include.php
Translation2_example.php
Translation2_gettext_example.php
translation2_include.php
UTF8.php
xml.php
xml.php
xml_test.php

Class: Translation2_Admin

Source Location: /Translation2-2.0.0beta11/Admin.php

Class Overview

Translation2
   |
   --Translation2_Admin

Administration utilities for translation string management


Author(s):

Copyright:

  • 2004-2005 Lorenzo Alberton

Methods

Inherited Variables

Class: Translation2

Translation2::$currentPageID
Translation2::$lang
Translation2::$options
Translation2::$params
Translation2::$storage

Inherited Methods

Class: Translation2

Translation2::Translation2()
Constructor
Translation2::factory()
Return a Translation2 instance already initialized
Translation2::get()
Get translated string
Translation2::getDecorator()
Return an instance of a decorator
Translation2::getLang()
get lang info
Translation2::getLangs()
get langs
Translation2::getPage()
Get an entire group of strings
Translation2::getRaw()
Get translated string (as-is)
Translation2::getRawPage()
Get the array of strings in a page
Translation2::getStringID()
Get the stringID for the given string. This method is the reverse of get().
Translation2::replaceEmptyStringsWithKeys()
Replace empty strings with their stringID
Translation2::setContainerOptions()
Set some storage driver options
Translation2::setLang()
Set default lang
Translation2::setPageID()
Set default page
Translation2::setParams()
Set parameters for next string
Translation2::_replaceParams()
Replace parameters in strings
Translation2::__clone()
Clone internal object references

Class Details

[line 57]
Administration utilities for translation string management

Set of methods to easily add/remove languages and strings, with a common API for all the containers.



[ Top ]

Method Detail

add   [line 253]

mixed add( string $stringID, [string $pageID = null], array $stringArray)

add a new translation
  • Return: true on success, PEAR_Error on failure

Parameters:

string   $stringID   —   
string   $pageID   —   
array   $stringArray   —   Associative array with string translations. Sample format: array('en' => 'sample', 'it' => 'esempio')

[ Top ]

addLang   [line 177]

mixed addLang( array $langData)

Prepare the storage container for a new lang.

If the langsAvail table doesn't exist yet, it is created.

  • Return: true on success, PEAR_Error on failure

Parameters:

array   $langData   —   array('lang_id' => 'en', 'table_name' => 'i18n', 'name' => 'english', 'meta' => 'some meta info', 'error_text' => 'not available');

[ Top ]

cleanCache   [line 324]

void cleanCache( )

If you use the CacheLiteFunction decorator, you may want to invalidate the cache after a change in the data base.

[ Top ]

factory   [line 78]

object Translation2 &factory( $driver, [mixed $options = ''], [array $params = array()], string $storageDriver)

Return a Translation2_Admin instance already initialized
  • Return: instance or PEAR_Error on failure
  • Access: public

Overrides Translation2::factory() (Return a Translation2 instance already initialized)

Parameters:

string   $storageDriver   —   Type of the storage driver
mixed   $options   —   Additional options for the storage driver (example: if you are using DB as the storage driver, you have to pass the dsn string here)
array   $params   —   Array of parameters for the adapter class (i.e. you can set here the mappings between your table/field names and the ones used by this class)
   $driver   —   

[ Top ]

getAdminDecorator   [line 149]

object Decorator &getAdminDecorator( string $decorator)

Return an instance of an admin decorator

Parameters:

string   $decorator   —   Name of the decorator

[ Top ]

getPageNames   [line 312]

array getPageNames( )

Get a list of all the pageIDs in any table.

[ Top ]

remove   [line 295]

mixed remove( string $stringID, [string $pageID = null])

remove a translated string
  • Return: true on success, PEAR_Error on failure
  • Todo: add a third $langs option, to conditionally remove only the langs specified

Parameters:

string   $stringID   —   
string   $pageID   —   

[ Top ]

removeLang   [line 207]

mixed removeLang( [string $langID = null], [boolean $force = false])

Remove the lang from the langsAvail table and drop the strings table.

If the strings table holds other langs and $force==false, then only the lang column is dropped. If $force==true the whole table is dropped without any check

  • Return: true on success, PEAR_Error on failure

Parameters:

string   $langID   —   
boolean   $force   —   

[ Top ]

update   [line 275]

mixed update( string $stringID, [string $pageID = null], array $stringArray)

Update an existing translation
  • Return: true on success, PEAR_Error on failure
  • Author: Ian Eure

Parameters:

string   $stringID   —   
string   $pageID   —   
array   $stringArray   —   Associative array with string translations. Sample format: array('en' => 'sample', 'it' => 'esempio')

[ Top ]

updateLang   [line 232]

mixed updateLang( array $langData)

Update the lang info in the langsAvail table
  • Return: true on success, PEAR_Error on failure

Parameters:

array   $langData   —   

[ Top ]
Documentation generated on Sat, 14 Oct 2006 08:26:56 -0400 by phpDocumentor 1.3.0. PEAR Logo Copyright © PHP Group 2004.