Land Down Under v601
Website engine - Copyright (C) 2003 Neocrome - ldu.neocrome.net - 2003-aug-31
Readme-upgrade-525-601-htm
How to upgrade Land Down Under from version 525 to version 601.
Upgrades from older versions arn't covered by this document.
  • 0 - Warning!
     
    Due to a new format for the structure, the upgrade process will put all pages and links and in validation queues. So you'll have to validate and change the category for each and every object in the 2 validation queues.
     
  • 1 - MySQL database upgrade
     
    A full backup of the database is highly recommended just before the upgrade !
    Then run /docs/ldu-upgrade-525-to-601.sql with phpMyAdmin to update the database to the very latest version.
     
  • 2 - Paths, URLs and system files
     
    Rename /plugins/standalone to /plugins/standard
    Rename /plugins/forums.posts to /plugins/fposts
    Rename /plugins/forums.topics to /plugins/ftopics
    Rename /plugins/forums.sections to /plugins/fsections
    Rename /plugins/autoload to /plugins/global
    Rename /datas/php to /plugins/code
     
    Rename all URLs (in vars.php, pages, menus, etc) :
     
    From list.php?cat=xxx&type=yyy to list.php?c=xxx
    From links.php?cat=xxx to links.php?c=xxx
     
  • 3 - Main files
     
    Replace all system files :
     
    /*.php (all files in the root)
    /system/*.* (and all sub-folders)
    /plugins/*.* (and all sub-folders)
     
    - Warning, delete the folder /system (and all files inside), and replace with the /system folder from v600.
    Do not copy/paste over existing v525 files, else you'll end with a lot of useless image files.
     
    You do NOT need to upload a new skin, your "old" one will still work fine, after all the changes listed below ;]
    You do NOT need to replace files in /datas/, apart if asked later in this manual.
     
  • 4 - Skins part I (Menus are now global and stored in the database)
     
    In header.tpl, replace all occurence of :
     
    {HEADER_FREETEXT1} by {PHP.ldu_freetext1}
    {HEADER_FREETEXT2} by {PHP.ldu_freetext2}
    {HEADER_FREETEXT3} by {PHP.ldu_freetext3}
    .........
    {HEADER_FREETEXT9} by {PHP.ldu_freetext9}
     
    {HEADER_MENU_1} by {PHP.ldu_menu1}
    {HEADER_MENU_2} by {PHP.ldu_menu2}
    {HEADER_MENU_3} by {PHP.ldu_menu3}
    .........
    {HEADER_MENU_9} by {PHP.ldu_menu9}
     
    In index.tpl, replace all occurence of :
     
    {NEWS_FREETEXT1} by {PHP.ldu_freetext1}
    {NEWS_FREETEXT2} by {PHP.ldu_freetext2}
    {NEWS_FREETEXT3} by {PHP.ldu_freetext3}
    .........
    {NEWS_FREETEXT9} by {PHP.ldu_freetext9}
     
    {NEWS_MENU_1} by {PHP.ldu_menu1}
    {NEWS_MENU_2} by {PHP.ldu_menu2}
    {NEWS_MENU_3} by {PHP.ldu_menu3}
    .........
    {NEWS_MENU_9} by {PHP.ldu_menu9}
     
    In footer.tpl, replace all occurence of :
     
    {FOOTER_FREETEXT1} by {PHP.ldu_freetext1}
    {FOOTER_FREETEXT2} by {PHP.ldu_freetext2}
    {FOOTER_FREETEXT3} by {PHP.ldu_freetext3}
    .........
    {FOOTER_FREETEXT9} by {PHP.ldu_freetext9}
     
    {FOOTER_MENU_1} by {PHP.ldu_menu1}
    {FOOTER_MENU_2} by {PHP.ldu_menu2}
    {FOOTER_MENU_3} by {PHP.ldu_menu3}
    .........
    {FOOTER_MENU_9} by {PHP.ldu_menu9}
     
    In index.archivestpl, replace all occurence of :
     
    {NEWSARCHIVES_FREETEXT1} by {PHP.ldu_freetext1}
    {NEWSARCHIVES_FREETEXT2} by {PHP.ldu_freetext2}
    {NEWSARCHIVES_FREETEXT3} by {PHP.ldu_freetext3}
    .........
    {NEWSARCHIVES_FREETEXT9} by {PHP.ldu_freetext9}
     
    THEN go in the the Administration panel > Configuration > Menus #1 (Main), and there copy paste all your menus from datas/vars.php
     
    Once this is done and saved in the database, delete the file datas/vars.php
     
    Also have a look in your datas/config.php, and compare with the config file from the v600 distribution, some entries arn't needed anymore (file extensions for the PFS and the 3 relative paths, the server timezone, and date masks).
     
    Remaining required directives are :
     
    $mysqlhost
    $mysqluser
    $mysqlpassword
    $mysqldb
    $ldu_adminemail
    $ldu_maintitle
    $ldu_subtitle
    $ldu_mainurl
    $ldu_defaultskin
    $ldu_defaultlang
     
  • 5 - Skins part II
     
    - Copy paste the folder /skins/*/img/system/ (and all images inside) from an official v600 skin to your own skin.
     
    - Copy/paste the files journal.*.tpl and journal.tpl from an official v600 skin to your own skin folder.
     
    - Copy/paste the file popup.tpl from an official v600 skin to your own skin folder, and change the skin code inside with your own code, so it links to the right CSS.
     
    - Delete those 4 obsolete files from your skin folder :
     
    list.short.tpl
    pages.adm.tpl
    links.adm.tpl
    events.adm.tpl
      
    - In forums.posts.tpl, near {FORUMS_POSTS_ROW_GALLERY}, add a tag : {FORUMS_POSTS_ROW_JOURNAL}
     
    - In header.tpl, near {HEADER_USER_PFS}, add a tag : {HEADER_USER_JOURNAL}
     
    - In index.tpl, add a tag : {NEWS_JRNLATESTPAGES}
     
    - In page.add.tpl, remove the whole <tr> block with : {PAGEADD_FORM_TYPE}
     
    - In page.edit.tpl, remove the whole <tr> block with : {PAGEEDIT_FORM_TYPE}
     
    - In page.tpl, in the block <!-- BEGIN: PAGE_FILE -->, replace {PAGE_TITLE} by {PAGE_SHORTTITLE}.
     
    - In forums.posts.tpl, replace {FORUMS_POSTS_ROW_USEREXTRA1} by {FORUMS_POSTS_ROW_AVATAR}
     
    - In forums.topics.tpl, replace : system/img/forums/newtopic.gif by skins/{PHP.skin}/img/system/newtopic.gif
     
    - In users.edit.tpl, replace {USERSEDIT_FORM_EXTRA1} by {USERSEDIT_FORM_AVATAR}
     
    - In profile.tpl, replace : <form action="{PROFILE_FORM_SEND}" method="post" name="profile"> by <form action="{PROFILE_FORM_SEND}" method="post" enctype="multipart/form-data" name="profile">
     
    - In users.details.tpl, replace : <a href="mailto:{USERSDETAILS_EMAIL}">{USERSDETAILS_EMAIL}</a> by {USERSDETAILS_EMAIL}
     
  • 6 - Skins part III
     
    In all changes listed below, change "class=..." according to your design !
     
    - In links.add.tpl, add a <tr> block for categories :
     
    <tr>
        <td class="back2"><b>Category :</b></td>
        <td class="back3">{LINKSADD_FORM_CAT}</td>
    </tr>
     
     - In profile.tpl, add a <tr> block for the user's avatar :
     
    <tr>
        <td class="back2"><b>Avatar :</b></td>
        <td class="back3">{PROFILE_AVATAR}</td>
    </tr>
     
     - In users.details.tpl, add a <tr> block for the user's journal :
     
    <tr>
        <td class="back2"><b>Journal :</b></td>
        <td class="back3">{USERSDETAILS_JOURNAL}</td>
    </tr>
     
     - In users.details.tpl, add a <tr> block for the comments counter :
     
    <tr>
        <td class="back2"><b>Comments posted :</b></td>
        <td class="back3">{USERSDETAILS_COMMENTCOUNT}</td>
    </tr>
     
     - In users.details.tpl, add a <tr> block for the 10 latest posts in forums :
     
    <tr>
        <td class="back2"><b>Recent posts in forums :</b></td>
        <td class="back3">{USERSDETAILS_LATESTPOSTS}</td>
    </tr>
     
      
  • 7 - Skins part IV (Multi-leveled categories)
     
    Copy/paste list.group.tpl and links.group.tpl form an official v600 skin to your own skin.
     
    In list.group.tpl, copy the whole block : <!-- BEGIN: LIST_ROWCAT --> ...... <!-- END: LIST_ROWCAT -->
    And paste it in list.tpl, right before the block : <!-- BEGIN: LIST_ROW --> ...... <!-- END: LIST_ROW -->
     
    In links.group.tpl, copy the whole block : <!-- BEGIN: LINKS_ROWCAT --> ...... <!-- END: LINKS_ROWCAT -->
    And paste it in links.tpl, right before the block : <!-- BEGIN: LINKS_ROW --> ...... <!-- END: LINKS_ROW -->
     
  • 8 - Skins part V (optional, sample to set up 2 extra fields in user profile)
     
    In all changes listed below, change "class=..." according to your design !
     
    - In profile.tpl, add two <tr> blocks for the extra fields #1 and #2:
     
    <tr>
        <td class="back2"><b>{PROFILE_EXTRA1_TITLE} :</b></td>
        <td class="back3">{PROFILE_EXTRA1}</td>
    </tr>
     
    <tr>
        <td class="back2"><b>{PROFILE_EXTRA2_TITLE} :</b></td>
        <td class="back3">{PROFILE_EXTRA2}</td>
    </tr>
     
     - In users.details.tpl, add two <tr> blocks for the extra fields #1 and #2:
     
    <tr>
        <td class="back2"><b>{USERSDETAILS_EXTRA1_TITLE} :</b></td>
        <td class="back3">{USERSDETAILS_EXTRA1}</td>
    </tr>
     
    <tr>
        <td class="back2"><b>{USERSDETAILS_EXTRA2_TITLE} :</b></td>
        <td class="back3">{USERSDETAILS_EXTRA2}</td>
    </tr>
     
     - In users.edit.tpl, add two <tr> blocks for the extra fields #1 and #2:
     
    <tr>
        <td class="back2"><b>{USERSEDIT_FORM_EXTRA1_TITLE} :</b></td>
        <td class="back3">{USERSEDIT_FORM_EXTRA1}</td>
    </tr>
     
    <tr>
        <td class="back2"><b>{USERSEDIT_FORM_EXTRA2_TITLE} :</b></td>
        <td class="back3">{USERSEDIT_FORM_EXTRA2}</td>
    </tr>
     
     Then in the Administration panel > Configuration > "Custom fields in the user profile", adjust settings for the custom fields #1 and #2.
    By default, field #1 is named "Real name" and field #2 is "Title".
    Note that those extra fields are also available in forums (posts view), see the Online Manual for details and tags.
     
  • 9 - Structure
     
    Go in the administration panel, section 'Structure', and organize/create/delete your categories.
    Due to the new format for the structure, all pages and links were sent back in validation queues, in some pre-set categories. So once you're done with the re-creation of categories, you'll have to validate and change the category for each and every object in the 2 validation queues.
     
    This screenshot of the LDU's home structure may help you to understand how it's working.
    There's also a basic explanation in the online manual HERE, READ IT !
     
    The advised method for a painless upgrade is :
     
    #1: Fully create your categories, with path codes and complete titles.
    #2: Then go in the validation queues for pages and links, and set the categories for each and every item.
     
  • 10 - Language packs
     
    A lot of new words in /system/lang/uk/main.lang.php, a lot of words removed, and new words or changes in most of plugins...
     
  • Links :
     
    - Online manual, general configuration, FAQ, articles, etc.
    - LDU forums, to meet other LDU webmasters, and technical support.
    - Licence and services, to order specific LDU services and support Neocrome.Net
    		•