-This is documentation of the process used while porting Trackers V2 from TikiWiki 1.9 to bitweaver.
|
{maketoc}
|
!Create the Directories
|
Well, first thing I'll do is create sub-dirs under my bitweaver install as per Fire's Tutorial_Custom_package.
|
-{CODE()}$ mkdir trackers2
|
+{code}$ mkdir trackers2 |
$ mkdir trackers2/admin
|
$ mkdir trackers2/icons
|
$ mkdir trackers2/modules
|
$ mkdir trackers2/plugins
|
-$ mkdir trackers2/templates{CODE}
|
+$ mkdir trackers2/templates{/code} |
|
!Copying the Files
|
First thing I'll do is copy the trackers library, root php files, modules and templates. I've used the '...' to indicate the previous command but with a different filename for brevity.
|
!!Libraries
|
-{CODE()}$ cp ../tw-1.9/lib/trackers/trackerlib.php trackers2{CODE}
|
+{code}$ cp ../tw-1.9/lib/trackers/trackerlib.php trackers2{/code} |
!!Root files (non-admin)
|
-{CODE()}$ cp ../tw-1.9/tiki-list_trackers.php trackers2
|
+{code}$ cp ../tw-1.9/tiki-list_trackers.php trackers2 |
...tiki-view_tracker_item.php
|
...tiki-view_tracker_more_info.php
|
- ...tiki-view_tracker.php{CODE}
|
+ ...tiki-view_tracker.php{/code} |
!!Root files (admin)
|
-{CODE()}$ cp ../tw-1.9/tiki-admin_include_trackers.php trackers2/admin
|
+{code}$ cp ../tw-1.9/tiki-admin_include_trackers.php trackers2/admin |
...tiki-admin_tracker_fields.php
|
- ...tiki-admin_trackers.php{CODE}
|
+ ...tiki-admin_trackers.php{/code} |
!!Icons
|
-{CODE()}$ cp ../tw-1.9/img/icons/admin_trackers.png trackers2/icons{CODE}
|
+{code}$ cp ../tw-1.9/img/icons/admin_trackers.png trackers2/icons{/code} |
!!Modules
|
-{CODE()}$ cp ../tw-1.9/modules/mod-last_modif_tracker_items.php trackers2/modules
|
- ...mod-last_tracker_items.php{CODE}
|
+{code}$ cp ../tw-1.9/modules/mod-last_modif_tracker_items.php trackers2/modules |
+ ...mod-last_tracker_items.php{/code} |
!!Templates (modules)
|
-{CODE()}$ cp ../tw-1.9/templates/modules/mod-last_modif_tracker_items.tpl trackers2/modules
|
+{code}$ cp ../tw-1.9/templates/modules/mod-last_modif_tracker_items.tpl trackers2/modules |
...mod-last_tracker_items.tpl
|
- ...mod-usergroup_tracker.tpl{CODE}
|
+ ...mod-usergroup_tracker.tpl{/code} |
!!Wiki Plugins
|
-{CODE()}$ cp ../tw-1.9/lib/wiki-plugins/wikiplugin_tracker.php trackers2/plugins
|
- ...wikiplugin_trackerlist.php{CODE}
|
+{code}$ cp ../tw-1.9/lib/wiki-plugins/wikiplugin_tracker.php trackers2/plugins |
+ ...wikiplugin_trackerlist.php{/code} |
!!Templates (non-modules)
|
-{CODE()} cp ../tw-1.9/templates/tiki-admin-include-trackers.tpl trackers2/templates
|
+{code} cp ../tw-1.9/templates/tiki-admin-include-trackers.tpl trackers2/templates |
...tiki-admin_tracker_fields.tpl
|
...tiki-admin_trackers.tpl
|
...tiki-list_trackers.tpl
|
...tiki-plugin_trackerlist.tpl
|
...tiki-view_tracker_item.tpl
|
...tiki-view_tracker_more_info.tpl
|
- ...tiki-view_tracker.tpl{CODE}
|
+ ...tiki-view_tracker.tpl{/code} |
!!Templates (notifications)
|
-{CODE()}$ cp ../tw-1.9/templates/mail/tracker_changed_notification.tpl trackers2/templates{CODE}
|
+{code}$ cp ../tw-1.9/templates/mail/tracker_changed_notification.tpl trackers2/templates{/code} |
|
!Renaming files
|
Its BW practise to remove the ''tiki-'' prefix from all PHP and Smarty templates.
|
-^Looking for PERL function to do this automatically^
|
-
|
-!Removing __tiki-__ references
|
-Next, I run a very destructive script __**BEWARE**__ - that removes all ''tiki-'' prefixes within all files.
|
-{CODE()}$ find -type f -exec perl -i -wpe 's/tiki-//g' {} \;{CODE}
|
+{code}cd trakers2 |
+find . | grep tiki- | sed -re "s/^(\S*)tiki\-(\S*)$/mv \1tiki-\2 \1\2/g" > tmp && sh tmp && rm tmp{/code} |
+Dirty but it works ;-) |
|
!index.php
|
Lets start with an index page. By default, we want list trackers to be the index page. Rather than rename the page, I'd suggest creating a new index.php file, and using a Location header to redirect to your preferred start page.
|
-{CODE()}<?php
|
+{code}<?php |
header ("location: sheets.php");
|
die;
|
-?>{CODE}
|
+?>{/code} |
|
!bit_setup_inc.php
|
Okay - all references to ''tiki-setup.php'' must be changed to ''../bit_setup_inc.php''. I've used a PERL command that will find and replace all instances of ''tiki-setup.php'' to ''../bit_setup_inc.php'' in all *.php files under ''trackers2'' directory.
|
-{CODE()}$ perl -i -pe 's/tiki-setup.php/..\/bit_setup_inc.php/g' `find trackers2 -type f -name '*.php'`{CODE}
|
+{code}$ perl -i -pe 's/tiki-setup.php/..\/bit_setup_inc.php/g' `find trackers2 -type f -name '*.php'`{/code} |
|
Now create a ''bit_setup_inc.php'' file in the ''trackers2'' directory. I've used the ''trackers/bit_setup_inc.php'' file as a template.
|
-{CODE(colors=>php)}<?php
|
+{code}<?php |
// Initialise global variables
|
global $gBitSystem, $gBitUser;
|
|