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 Garage.
First upload the following:
- upload garage.php to your ./sources/ folder.
- garage_functions.php to your ./sources/lib/ folder.
- lang_garage.php to your ./lang/en/ folder.
- garage_camera.gif and p_garage.gif to your ./style_images/1/ folder.
- 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!
- garage_loader.php to your ./sources/lib/ folder.
- ad_garage.php, ad_garage_cat.php, ad_garage_makes.php, ad_garage_mod.php, ad_garage_perms.php, ad_garage_tools.php, and ad_garage_loader.php to your ./sources/admin/ folder.
Ensure that your ./uploads directory permissions are CHMOD 0777
You will need to edit the following files:
./index.php
./admin.php
./sources/admin/admin_pages.php
You will need to obtain a FREE license, instructions below!
Optionally you may edit the following files:
./lang/en/lang_online.php
Optionally you may edit the following skin bit in your ACP:
All Global HTML -> global_board_header
>>>Step 1:
Installing ionCube loader
For the Garage to operate you will need to
install the ionCube loader if it
is not already installed on your server.
>>>Step 2:
Open ./admin.php and Find
'blog' => array( 'blog' , 'blog' ),
Add after that:
//------------------
// Garage Mod
//------------------
'garage' => array( 'garage' , 'garage' ),
'garage_tools' => array( 'garage_tools' , 'garage_tools' ),
'garage_cat' => array( 'garage_cat' , 'garage_cat' ),
'garage_mod' => array( 'garage_mod' , 'garage_mod' ),
'garage_perms' => array( 'garage_perms' , 'garage_perms' ),
'garage_makes' => array( 'garage_makes' , 'garage_makes' ),
//------------------
// Garage Mod End
//------------------
save and upload ./admin.php
>>>Step 3:
Open ./sources/admin/admin_pages.php and Find
1700 => array(
1 => array( 'View Moderator Logs' , 'act=modlog' ),
2 => array( 'View Admin Logs' , 'act=adminlog' ),
3 => array( 'View Email Logs' , 'act=emaillog' ),
4 => array( 'View Email Error Logs', 'act=emailerror' ),
5 => array( 'View Bot Logs' , 'act=spiderlog' ),
6 => array( 'View Warn Logs' , 'act=warnlog' ),
),
Add after that (change '1800' if it is already there):
//------------------
// Garage Mod
//------------------
1800 => array (
1 => array( 'Documentation' , 'act=garage&code=docs' ),
2 => array( 'Configuration' , 'act=garage' ),
3 => array( 'Tools' , 'act=garage_tools' ),
4 => array( 'Makes & Models' , 'act=garage_makes' ),
5 => array( 'Categories' , 'act=garage_cat' ),
6 => array( 'Permissions' , 'act=garage_perms' ),
7 => array( 'Moderation' , 'act=garage_mod' ),
),
//------------------
// Garage Mod End
//------------------
Add then find:
1700 => array( 'Board Logs' , '#f5cdcd' ),
REPLACE that with:
1700 => array( 'Board Logs' , '#f5cdcd;margin-bottom:12px;' ),
//------------------
// Garage Mod
//------------------
1800 => array( 'Garage Management', '#CDCDF5;margin-bottom:12px;' ),
//------------------
// Garage Mod End
//------------------
Add then find:
1700 => "View admin, moderator and email logs (Root admin only)",
Add after that (change '1800' if it is already there):
//------------------
// Garage Mod
//------------------
1800 => 'Configuration, tools, categories, permissions and moderation of your Garage',
//------------------
// Garage Mod End
//------------------
save and upload ./sources/admin/admin_pages.php
>>>Step 4:
Open ./index.php and Find
'findpost' => array( 'findpost' , 'findpost' ),
Add after that:
//------------------
// Garage Mod
//------------------
'garage' => array( 'garage' , 'garage' ),
//------------------
// Garage Mod End
//------------------
Add then find:
$ibforums->member = $sess->authorise();
$ibforums->lastclick = $sess->last_click;
$ibforums->location = $sess->location;
$ibforums->session_id = $sess->session_id; // Used in URLs
$ibforums->my_session = $sess->session_id; // Used in code
Add after that:
//------------------
// Garage Mod
//------------------
session_id($ibforums->my_session);
session_start();
//------------------
// Garage Mod End
//------------------
save and upload ./index.php
>>>Step 5: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 6: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 -> Skins & Templates -> 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 v2.0.2 (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.2 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 ;)
>>>>> Optional Add-on:If you want to show in the Online Users list if someone is using the Garage:
Open ./lang/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 ./lang/en/lang_online.php
>>>>> Optional Add-on:Add a simple link to your garage in the header:
NOTE: You can place this link anywhere, this is merely a suggestion.
In your Skin Manager edit the following Template Bit:
"All Global HTML" -> "global_board_header" and find
<!--IBF.CHATLINK-->
Add BEFORE that:
<a href='{ipb.script_url}act=garage'>Garage</a>
save Template Bit
>>> 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.garagemodule.com/product_order.phpOnce you have filled in the form details you will be presented with the Client Area.
Click on the
View License button. This will bring up the
Product License Information window. Located on the bottom of this window is your License Number. This information also gets emailed to you.
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 will need to apply for an additional License Number.
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
Add Comment