Changeset 237 for trunk/docs

Timestamp:

Mar 8, 2007 4:02:29 AM (17 years ago)

Author:

quinn

Message:

 

File:

• trunk/docs/codebase_v1-to-v2_upgrade_checklist.txt (modified) (4 diffs)

trunk/docs/codebase_v1-to-v2_upgrade_checklist.txt

@@ -22 +22 @@
     require_once 'codebase/lib/Utilities.inc.php';
     
+    
 3. $CFG-> variables are gone. Most of these should be converted into their $app and $auth equivelents. If a $CFG variable is NOT something used by the codebase but is still needed by the website application, I suggest converting these values to a $cfg array. For example, this:
 
@@ -32 +33 @@
 (And of course change the code where they are used to support the array instead of object-properties. If the array is inside of double-quotes it should be written like "{$cfg['gallery_images_url']}/my/path".)
 
+
 4. $CFG->site_url is not needed when referencing URLs. Change this:
 
@@ -41 +43 @@
     
 (In otherwords, the URL should be a not-fully-qualified URL starting with a slash.)
-    
+
+
+5. Expect formatting incosistencies! When doing global search-replace expect whitespace to be erratic, variable names to change, and lines to be otherwise inconsistent. Here's a good example of a safe way to match a line:
+
+Searching for "$CFG->ssl_domain = 'www.example.com';":
+
+    $CFG->(\w+)\s*=\s*['"](\w+)['"];
+
+Replace:
+
+    $app->setParam(array(
+        '\1' => '\2'
+    ));
+    
+    
+6. Many classes now require object-method calls, and the object must be globally scoped. For example, to call the $cache->exists() method inside a function, be sure to add:
+
+    global $cache;
+    
+at the top of the function.
 
     
@@ -262 +283 @@
 
 
-=====================================================================
-HINTS
-=====================================================================
-
-1. Expect formatting incosistencies! When doing global search-replace expect whitespace to be erratic, variable names to change, and lines to be otherwise inconsistent. Here's a good example of a safe way to match a line:
-
-Searching for "$CFG->ssl_domain = 'www.example.com';":
-
-    $CFG->(\w+)\s*=\s*['"](\w+)['"];
-
-Replace:
-
-    $app->setParam(array(
-        '\1' => '\2'
-    ));
-    
-2. Many classes now require object-method calls, and the object must be globally scoped. For example, to call the $cache->exists() method inside a function, be sure to add:
-
-    global $cache;
-    
-at the top of the function.
-
-3. 
-
 
 ?>