[cvs] [Wiki] changed: Doc/Dev/ConversionH4

[Michael Slusarz]

slusarz  Tue, 04 May 2010 19:18:28 -0400

Modified page: http://wiki.horde.org/Doc/Dev/ConversionH4
New Revision:  1.1
Change log:  More notes

@@ -2,37 +2,91 @@

  + H4 Conversion !HowTo

  Items that need to be converted...
+
+++ Authentication
+
+Remove AUTH_HANDLER - use Horde_Registry::appInit() 'authentication'  
option instead.
+Remove $session_control - use Horde_Registry::appInit()  
'session_control' option instead

  ++ Autoloading

  Convert files/libraries to be able to be autoloaded.
  Remove require/include calls within the code.

-++ Remove CVS remnants
+++ CLI
+
+Use Horde_Registry::appInit(), with the 'cli' option, to initialize  
CLI scripts.
+
+++ Configuration files
+
+Add $Id$ tag to all conf/*.php.dist and conf/*.xml files
+
+++ Convert Base files
+
+No more lib/base.php, lib/api.php, lib/version.php.  Converted to  
lib/Application.php and lib/Api.php
+
+++ Convert to PHP 5
+
+TODO
+instanceof instead of is_a()
+
+++ CVS remnants

  No need for $Horde$ in header comments.
+Remove CVS directories.
+Remove .cvsignore

  ++ Constants

  Constants should be namespaced - preferably within the utility class  
(e.g. lib/App.php).
+
+++ Documentation
+
+Update documentation.

  ++ Globals

  Remove all use of globals within the application (use injector instead).

  ++ Injector Usage

  Various Horde libraries now must be loaded via the injector.
+
+++ Javascript
+
+ALL javascript should be in js/.  NO javscript (if at all possible)  
should be contained in scripts/templates.
+
+++ Log handling
+
+Log constants have changed.
+
+++ MIME library
+
+The MIME library has been rewritten - most calls to the library will  
probably need to be changed.

  ++ Output buffering

  Convert from Util::bufferOutput() -> Horde::startBuffer()
+
+++ PEAR_Error
+
+Remove PEAR_Error usage - convert to Exceptions.
+Each application should define a APP_Exception library that extends  
Horde_Exception.

  ++ Prefs UI

-TODO
+No more lib/prefs.php - now uses Horde_Registry_Application calls.
+Update config/prefs.php.dist to remove unneeded entries.
+
+++ Test script
+
+No longer uses test.php - converted to lib/Test.php.

  ++ Themes

  TODO
+
+++ Url generation
+
+Use Horde_Url:: instead of  
Horde_Util::addParameter()/Horde_Util::removeParameter().