Changes between Version 1 and Version 2 of HowToMakeAutomaticUpgradeScriptForModule


Ignore:
Timestamp:
Jul 8, 2013, 11:14:15 AM (11 years ago)
Author:
AntonL
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • HowToMakeAutomaticUpgradeScriptForModule

    v1 v2  
    11== How to make automatic upgrade script for module == 
    22 
    3 There is a prepared zip package with the simplest update for Dolphin 7 module [here]. Download it, unpack and upload to the '''modules/me/bloggie/updates/''' folder. '''bloggie''' folder is the root folder of Bloggie module which was described [http://www.boonex.com/trac/dolphin/wiki/DolphinTutorialMyFirstModule here], '''updates''' folder is a folder for all updates for Bloggie module, if it doesn't exist then you need to create it. 
     3There is a prepared zip package with the simplest update for Dolphin 7 module [here]. Download it, unpack and upload to the '''modules/me/bloggie/updates/''' folder. '''bloggie''' folder is the root folder of Bloggie module which was described [http://www.boonex.com/trac/dolphin/wiki/DolphinTutorialMyFirstModule here], '''updates''' folder is a folder for all updates for Bloggie module, if it doesn't exist then you need to create it.[[BR]] 
    44 
     5The zip package contains '''update_100_110''' folder. It is up to you how to name the folder but it is a good practice to include "version from" and "version to" into the folder name, it is just more clear. Lets describe each file in the update. This is almost the minimal set of files for the module's update:[[BR]] 
    56 
     7'''bloggie/updates/update_100_110/install/'''[[BR]] 
     8Update installation directory, where all installation files are located, like SQL files and language files.[[BR]] 
     9'''bloggie/updates/update_100_110/install/config.php'''[[BR]] 
     10Update installation config file. We will take a closer look at this later.[[BR]] 
     11'''bloggie/updates/update_100_110/install/installer.php'''[[BR]] 
     12Update installer class. You can add some custom installation scripts and override default behaviour.[[BR]] 
     13'''bloggie/updates/update_100_110/install/info'''[[BR]] 
     14Installation information messages folder. If you need to display information messages upon update install, you will need to place files here - also special instructions are needed to point to in the install config file to display these messages properly.[[BR]] 
     15'''bloggie/updates/update_100_110/install/langs'''[[BR]] 
     16Update languages must be located in this dir. The language file must be a php file with the name of two letters of the language code.  We will take a closer look at an example of the language file later.[[BR]] 
     17'''bloggie/updates/update_100_110/install/langs/en.php'''[[BR]] 
     18An update for default English language file.[[BR]] 
     19'''bloggie/updates/update_100_110/install/sql'''[[BR]] 
     20SQL script for update install is here.[[BR]] 
     21'''bloggie/updates/update_100_110/install/sql/install.sql'''[[BR]] 
     22Update installation SQL file.[[BR]] 
     23'''bloggie/updates/update_100_110/source'''[[BR]] 
     24A folder with files and folders which should be uploaded in module's folder. So, files and folders structure should match module's one. You may read more about module's file structure [http://www.boonex.com/trac/dolphin/wiki/DolphinTutorialMyFirstModule here].[[BR]] 
     25 
 
Below is the legacy version of the Boonex site, maintained for Dolphin.Pro 7.x support.
The new Dolphin solution is powered by UNA Community Management System.
Fork me on GitHub