Upgrading and Installing note: As with any change to files on your server you should always make a backup of any files that will be modified or removed. It would also be good practice to make a backup of your database.
INSTRUCTIONS FOR NEW INSTALL
These instructions are for a new fresh install.
Please see the appropriate
upgrade instructions on upgrading the Garage Module.
First upload the following:
- /cache/lang_cache/en/lang_garage.php
- /sources/action_public/garage.php
- /sources/lib/garage_functions.php
- /sources/portal_plugins/garage.php
- /sources/portal_plugins/garage-cfg.php
- /style_images/1/garage_camera.gif
- /style_images/1/p_garage.gif
- install_garage_sql.php to your ./forums root folder (the same folder containing index.php)
Upload the following in BINARY mode, DO NOT let your FTP client 'Automatically' choose ASCII or BINARY!
!!! IF YOU DO NOT UPLOAD THESE IN BINARY THE GARAGE WILL NOT WORK !!!
If for some reason you need ASCII versions of these files upload the files from the 'ASCII_encoded_files' folder instead, but still in BINARY mode!
- /sources/lib/garage_loader.php
- /sources/components_acp/garage.php
- /sources/components_acp/garage/* (All the files)
Ensure that your ./uploads directory permissions are CHMOD 0777
You will need to edit the following files:
./index.php
You will need to obtain a FREE license, instructions below!
Optionally you may edit the following files:
./cache/lang_cache/en/lang_online.php
>>>Step 1:
Installing ionCube loader (SKIP if you are using the Zend version)
For the Garage to operate you will need to
install the ionCube loader if it is not already installed on your server. Or you may choose to use the Zend version and skip this step.
>>>Step 2:
Open ./index.php and Find
'component' => array( 'component' , 'component' , array() ),
Add after that:
//------------------
// Garage Mod
//------------------
'garage' => array( 'garage' , 'garage' , array() ),
//------------------
// Garage Mod End
//------------------
Add then find:
$ipsclass->member = $ipsclass->sess->authorise();
$ipsclass->lastclick = $ipsclass->sess->last_click;
$ipsclass->location = $ipsclass->sess->location;
$ipsclass->session_id = $ipsclass->sess->session_id; // Used in URLs
$ipsclass->my_session = $ipsclass->sess->session_id; // Used in code
Add after that:
//------------------
// Garage Mod
//------------------
session_id($ipsclass->my_session);
session_start();
//------------------
// Garage Mod End
//------------------
save and upload ./index.php
>>>Step 3:To install the needed SQL tables and data use the uploaded file install_garage_sql.php. Execute that file from your web browser. DO NOT EXECUTE this from within any site management software such as Cpanel! Follow the instructions and when you are finished REMOVE install_garage_sql.php from your site!
>>>Step 4:Importing and setting up the skin. This is a tricky procedure, please follow it closely ;) Since the garage skin combines edits to other template bit groups, and a custom macro, you can not simply place a copy of the skin_garage.php file into your skin cache folders and be done. If for some reason your XML skin import function is not working you need to resolve that problem before continuing to ensure skin inheritance functions properly!
i) Head into your ACP -> Look & Feel -> Skin Import/Export
ii) In the 'Upload XML Template set' box, click Browse and choose the included ipb_skin-garagev2.0.xml.gz file.
iii) In the New Skin Set Name? box you may leave it blank or type in a custom name. It will default to Garage Module v2.0.4 (imported) if you do not enter a custom one.
iv) Click Import Skin XML. Ensure no errors occur.
v) Now you have a choice depending on what you have already done in terms of skinning.
If you have a skin set already that you have done modifications to, then set that skin to have this newly imported skin as the parent. This will ensure that the skin inheritence works and you maintain all your custom edits along with the garage elements.
To set another skin set to have the garage skin set as the parent click on the other skin set on the 'Skin Manager' page, choose
Edit Settings. For the
Skin Set Parent? option choose
Garage v2.0.4 or whatever you named the newly imported skin set. Click
Edit Skin Settings, that's it!
It is not suggested that you do your site skin modifications to the imported garage skin set. Keep the garage skin set as is so future upgrades to the garage skin will be painless for you ;)
>>>Step 5:Importing and setting up the component settings. The installation of the administration of the Garage is much easier than before, and doesn't require any page edits. Once you complete this process below you will find the administration for your Garage in your ACP -> Components screen. If you have sub-admins you can also configure permissions for the Garage administration through the ACP -> Admin -> Manage Restrictions page. This process will also automatically add a link to your board header.
i) Head into your ACP -> Admin -> Manage Components.
ii) In the 'Upload XML components file from your computer' box, click Browse and choose the included garage_component.xml file.
iii) Click Import. That's it!
>>> Optional Add-on:If you want to show in the Online Users list if someone is using the Garage:
Open ./cache/lang_cache/en/lang_online.php and find
WHERE_stats => "Viewing Stats",
Add after that:
//------------------
// Garage Mod
//------------------
WHERE_Garage => "Using the Garage",
//------------------
// Garage Mod End
//------------------
save and upload ./cache/lang_cache/en/lang_online.php
>>> FINAL STEP - License Number (Important, don't skip ;)
Obtain FREE License Number
For the Garage to operate you will need to obtain a License Number. License Numbers do not cost anything, but are required to enable the Garage to operate. Please visit this location to obtain your License Number:
http://client.fusionscripts.com/Once you have filled in the form details you will be presented with the Client Area.
Click on the
View Your Licenses link on the left menu. Then click on
View and Download to view your license.
Head into your Admin CP and click on any of the Garage Management items. A form will be displayed asking for your License Number. Paste your License Number and click
Save. This will activate your License Number and 'lock' it to your domain name. If you wish to install the Garage at another location you can log into the client area and reissue your license.
That's it you're done with installation!
You can access the Garage Module by pointing your browser to:
http://www.yoursite.com/forums/index.php?act=garage Change yoursite.com to your website name.
The first thing you will want to do is go into your AdminCP and go through the Configuration options for the Garage, reading each carefully! Then add your Modification Categories.
Please note that many features are disabled by default, you will need to enable them in your AdminCP. All editable text is available in the language section of your AdminCP under the filename lang_garage.php.
To make changes to the list of available currencies:
- Open: ./sources/lib/garage_functions.php,
- Find: function build_currency_html()
- Modify as Needed
Please keep the copyright line in the code.
For help please check out the
support forums.
Glossary
Documentation
Installation
Email
Print