[iAG] Nulled 2007 Built2Go Car Dealer

Copyright ă 2005-2007 [iAG] Nulled

Version 1.0.8

 

 

 

Table Of Contents

 

 

1)  Introduction

2)  Requirements

3)  Installation

4)  Template Settings

5)  Newsletter

6)  Car Listings

7)  Locations

8)  Adding Events

9)  Poll

10)         FAQ

11)         Renewal Process

12)         Payment Processors

13)         Sponsors

14)         Buyers / Sellers / Dealers

15)         System Info

16)         Admin

17)         Approving

18)         Upgrading

19)         Support

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Introduction:

 

B.u.i.l.t.2.G.o is dedicated to providing you high quality, preprogrammed website templates using PHP scripts to start an instant turnkey website with no programming required (although some experience in installing a PHP script may be necessary, but not required).

B.u.i.l.t.2.G.o also offers HTML versions of all templates, PSD source files for making design modifications in Photoshop, and Corporate IDs and Banner sets to open your shop with a full identity, ready to use.

B.u.i.l.t.2.G.o is also set up to accept your PayPal, 2Checkout and Worldpay accounts.

 

 

 

Requirements:

 

Server Tested on Apache/1.3.12 & 2.0 (Unix/redhat)

PHP >= 4.1.2   (will not work on anything below 4.1)

Register_globals are recommended to be OFF for best performance

GD Library 2.0+ - with FreeType enabled.

Mysql (tested with 4.01.x)

Zend Optimizer or ionCube Loader (both are free)

     Must be installed on server prior to running script install.

 

   

Package Contents:

 

Your [iAG] Nulled Car Dealer Site package includes:

 

B2GCarDealerSiteX.zip

B2GCarDealerSiteDesignX.zip

 

     Where X is a number followed by a letter: eg: 1A or 1B

 

 

Inside your folder named B2GCarDealerSiteDesignX you’ll find:

·        Built2GoLicenseAgreement.pdf

(If you require a PDF reader, CLICK HERE for a free download!)

·        Banner folder – contains animated .gif banners and buttons, plus editable Photoshop images including fonts!

·        CorpId folder – contains editable logo, letterhead, business card, and envelope images

·        Fonts folder

·        Html folder – contains a filled and blank version of the site in HTML

·        Jpg folder – contains screenshot images of each page in JPG format

·        Psd folder – contains screenshot images of each page in PSD format

·        Screenshots folder – contains screenshot images of each page in GIF format

 

These files may be edited to suit your needs using Photoshop.

 

 

Inside your folder named B2GCarDealerSiteX you’ll find:

·        CarDealer_readme.doc (you’re reading it right now!)

·        Built2GoLicenseAgreement.pdf

(If you require a PDF reader, CLICK HERE for a free download!)

·        Scripts folder

 

 

 

 

Installation Instructions:

 

Open the Scripts folder from the B2GCarDealerSiteX.zip package.

By default the script comes with Zend Encoded system_cls.php file. If you do not have Zend Optimizer installed on the server but you have ionCube, then rename system_cls.php to system_cls_zend.php and rename system_cls_ioncube.php to system_cls.php.

Transfer ALL of these files to your webspace using an FTP program.

 

http://www.ipswitch.com/products/ws_ftp/home/index.asp

http://www.smartftp.com/

 

*MOST FTP programs (including the recommended above) will automatically detect the type of file you are transferring, and upload it in the proper mode. If yours doesn’t, PHP files need to be uploaded using ASCII mode, besides system_cls.php which needs to be upload in BINARY mode, image files and .tff files need to be uploaded in BINARY mode as well.

 

Lets begin!

 

First we need to edit a file. Open config.php using notepad.

 

1.  Set your language(default is English).

 

define('SCRIPT_LANG', "eng");

 

2.  The following is where you have installed the script if you’ve placed it in your “root directory”. (for example, http://www.yourdomain.com)

 

define('SITE_URL', "http://".$_SERVER['SERVER_NAME']); //no ending slash.

 

If you have placed your script in a sub-directory (for example, http://www.yourdomain.com/cardealer) then you will need to alter this line to look like this:

 

define('SITE_URL', "http://".$_SERVER['SERVER_NAME']."/cardealer";

 

3.  You will also need to do the same to the following line if you have installed your site in a sub-directory:

 

define('FULL_PATH', $_SERVER['DOCUMENT_ROOT']);

or

define('FULL_PATH', $_SERVER['DOCUMENT_ROOT']."/cardealer");

 

If by chance you know that your server is on a Windows OS box than you have to edit the above line to be like this instead:

 

define('FULL_PATH', "c:/Inet/www/path/script_name");

 

 

4.  The following is for spam control. This is used on the contact page and anypage that used emailing. An extra step in controlling how many emails a person can send so it doesn’t flood your email inbox.

 

define('FLOOD_TIMEOUT',"1800");  // max time in seconds

 

5.  For images it is important to set a set width and height as well as a maximum file size. If the images are too wide or too high, then it might distort the template design. So we have added a max-height and a max-width of 500 pixels as a default. File size is up to you. The bigger the file the more room it takes up on your server/web space. Use at your discretion. Lowestimage_w_size is the lowest image size you will accept. Works only for the thumbnail images. This way the image won’t be so small it distorts the design.

 

define('MAXFILE_SIZE',"100");  // in thousands.

define('MAXIMAGE_W_SIZE',"500");  // max image width

define('MAXIMAGE_H_SIZE',"500");  // max image height

define('LOWESTIMAGE_W_SIZE',"66");  // Lowest image width

 

 

6.  Don’t forget to add your email address!

 

 

7.  For the payment modules to work, these variables need to be set.

Each should be setup to the specifications of each merchant.

 

·        ITEM_NAME is what you wish to call your transaction during the payment process; name it how you see fit. (default is CarDealerItem)

 

·        CURENCY_CODE is for PayPal only. This sets up your currency to use with Paypal, change it to see fit. (default is USD)

 

·        CURRENCY setting is for your currency symbol.

 

define('CURRENCY', "$");

 

 

         /* payment processors here PAYPAL*/

     define('FROM_PAYPAL',"paypal@paypal.com"); (change to YOUR PayPal address!)

     define(ITEM_NAME," CarDealerItem");

     define('CURRENCY_CODE', "USD"); // used mostly with paypal

         /* Worldpay */

     define('INSTID',"123456"); // worldpay login #

         /*2Checkout*/

     define('SERIAL_ID',"123456"); // 2checkout login #

      

      

8.  This line of script allows you to add a prefix to your table names for Mysql. This gives the script a little bit more security, as people can’t guess at what you called your table names. This is to thwart hackers that attempt to get your Mysql information.

 

      

     /* Mysql Table prefix must be set here */

      define('TABLE_PREFIX',"");

 

Change it (if desired) like this:

 

     /* Mysql Table prefix must be set here */

      define('TABLE_PREFIX',"yourprefix");

 

 

9.  The country setting is set here. This controls what default country the user sees on signup and car listing pages. Defaults to US. For more information:

example: GB  UNITED KINGDOM

       US   UNITED STATES

       UM   UNITED STATES MINOR OUTLYING ISLANDS

  http://www.iso.org/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.html

 

define('C_ISO',"US");

 

 

10.    Price formatting is mainly for the users that require the price be different. Eg: US price format is 1,000.00, French format is 1 000,00

 

     define('DECIMAL_SEP',".");
     define('THOUSANDS_SEP',",");

 

 

11.    If the following variable is set to 1 the session table has a tendency to get big.

 

     $GLOBALS['noshutdownfunc'] = 1;

 

This will allow the script to clear out any old information that is not needed anymore. The script is set to 1 for the install, but it is recommended to set it to 0 “after” the install is done.

 

 

 

Once everything is edited in your config.php file and you have saved it and uploaded the changes, we need to install your site!

 

BEFORE YOU BEGIN: Next, Please make sure you CHMOD the admincp folder to 777 (full writable permissions) so the install script can add or update a file. Once finished you can CHMOD it back to 755.

(If you are unsure how to do this, consult the Help files in your FTP program.)

 

Open your browser, and type in the address bar:

 

http://www.yourdomain.com/install.php.

 

If you have placed your script in a sub-directory, don’t forget to add that to your address!

 

http://www.yourdomain.com/cardealer/install.php

 

 

Run this file and it will walk you through your installation. Once you have successfully installed the script, you must delete the install.php file from your webspace! Keep a backup on your local hard drive.

 

 

*Now would also be a good time to change the config.php file as instructed above:

$GLOBALS['noshutdownfunc'] = 0;

 

 

Once everything it uploaded we need to set some permission on certain folders. Windows usrs shouldn’t’ have to do this unless the permissions are not set for that user. We need to set “dtl_pic”, “org_pic” and the “thumb_pic” folders to 777 so we can upload images to them when users add listings.

 

 

Included is a file called pinfo.php, This will also tell you what is installed with your php package. Please have this page ready to view if you ever have a need to contact support at http://www.built2go.com/pmos/

 

 

 

Template settings:

 

     Viewing templates is very easy. After you login to the admin, click on the ‘View Template Files’ link on the left hand side. Every template the system uses is in this list. Click on the desired template name and click on edit. If you click on a Category then you have to click on expand to list the templates in this category, then click on the desired template to edit.

 

The screen will then show a box with the template in it. It is plain html with some variables in it. If you made a mistake by deleting a variable the system uses you can use the “Revert” function at the bottom. This will revert the template back to the default template when the system was installed. Every template will have this option.

 

 

Adding a template is more difficulty in this version of Car Dealer. You are welcome to add a template but then you have to edit the Mysql database if you want it in a certain section. This may change in future version. Adding a template will not show up on the site until you add the template name or code to the php script it is intended for. It is recommended that experience users only do this.

 

 

There is an import/export utility for importing or exporting template designs. Maybe used for backing up your templates if something ever went wrong. Future version will have the ability to add extra style (theme) for the user to switch between. As for now importing is useless, as the script will not see the new style.

 

 

Newsletter:

 

     Every user has a choice to be added to the newsletter listing when they signup or edit their profile.

 

In the adminpanel you have section where you can fill out and send a newsletter or a site updates email.

 

The “from address” can be anything you want. Usually it is an email where you don’t want anybody to reply to, so it can be a fake address. Pick the date range you want to include and the system will look for those ranges and insert any new listings into the newsletter. After that pick who you are sending it to, if set to admin it will only go to you. Then pick a subject and how many users you wnt to send to per page. The higher the number the more time it will take. If you pick to high of a number you will take a chance of bring down the mail server by over-loading it. So keep it fairly small, 500-1000. The last thing is the text for the newsletter. If you want the latest additions from the site you have to leave the variables “$timeframe” and “$updates” in there. You can add whatever else you want.

 

Once you have finished just press submit. Once the next page has gone through the allotted emails it will either say done or continue on with the next batch.

 

 

 

Makes and Models:

 

By default this script come with a pre-defined set of makes and models. It is by no means an exhaustive list and you are welcome to edit/add/delete any make or model you see fit. Clicking on a automobile in the list will show you all models associated with it.

 

Car List:

 

     This page will show all the cars that are added pending or disabled or active. Here you are able to add the certain car listing to be featured. You can also view, disable, edit or delete the car here.

 

 

Adding Car Listings:

 

     Adding cars should be self-explanatory. First, fill in the information pertaining to the new car. Once you have the correct essentials in this form than push the “Submit” button. Make sure you select a user before adding this car. If you just installed the script then just add a default user on the front end. Once you added this user then just select him/her for all your car listings that you add in the admin.

 

 

Featured Cars:

 

     This lists all cars that are set to featured. When deleted out of here they will only be deleted from this section, not the car list section.

 

Searching:

 

     This page allows you to search for a certain car. Will search for make, model, year, id, color, price, mileage, transmission type, engine, VIN #, stock #, if sold, city and state.

 

 

 

Locations:

 

     This page will show all the states and countries that are listed to the user. You can edit or delete a state or country or you can add a state to a certain country. Make sure if you set the default C_ISO setting in the config file that you have edited the locations pertaining to this country. If you do not edit it then the states selection for the user will be empty. States can be providences or whatever.

 

 

 

 

Adding Events:

 

     Events are like what is happening around the city or country where you live. It is to promote certain car sales or news. Or just whatever you think is appropriate for this section. It will appear on the front page for everybody to see.

 

 

 

 

Poll:

 

     This section should be self-explanatory. If a poll is added it will show on the site. It is possible to have a poll disabled and still not show on the site even if the poll setting is enabled. You have to have a poll enabled for it to show up in the left hand column of the site.

 

 

 

Frequently Asked Question:

 

     This section allows you to add the most asked question you receive or the question you think the user might ask. Adding a question is easy.

1.     First we add a section that this question will be under.

2.     Once the section is added we can add a question to that section. On the question screen you will need to select the section it pertains to. All questions must have a section.

 

Important: If you delete a section that has questions in it then all questions will be deleted along with that section.

 

 

 

 

 

Script Processing (Renewal):

 

This section is very important. It will run a batch script that will search the database for expired members or members that will expire in a day or two. You have test link to test it out to see if the correct Users are expiring. The live version will send an email to the members saying if they expire today or tomorrow or has already expired. It is very possible to make this into a cron job so it is automatically ran. If you are unfamiliar with cron jobs then it is recommended to look it up on google.com. Support will not tell you how to set it up, this has to be done by you.

 

 

 

Payment Processors:

 

By default this script will make use of Worldpay, Paypal and 2checkout. You are not required to use all three. If you want just Paypal then disable the other two in the admin. The rest of the script will not see them until you enable them.

 

If you have a new merchant and this script will not run them, you are more than welcome to make one. The module as to be specifically named, It has to have “module-” before it.

 

     module-paypal.php or module-worldpay.php etc… must also have a dash after module. If by chance you make a new script for another merchant could you please send it to me and I will credit all the work for you J

 

     Paypal – Worldpay – 2Checkout:

    

     These merchants will need the return URL if you use the IPN. This url is the module directory and the corresponding module.

 

http://www.yoursite.com/modules/module-paypal.php

http://www.yoursite.com/modules/module-paypal_1t.php

http://www.yoursite.com/modules/module-worldpay.php

http://www.yoursite.com/modules/module-2checkout.php

 

 

You will need to give this URL to a text field in your merchant account on said merchants.

 

Paypal requires you to turn on IPN for this to work. This is located in your Paypal account page. You do not need to enter the return url or the IPN url, this is set by the script. Just enable IPN and then enable POST back to the thank you page. Again you do not need to add the return url.

 

For testing purposes on 2checkout you can add this line to the 2checkout form:

 

Admincp -> View Template Files -> Payment Form Templates -> 2checkout

 

<input type="hidden" name="demo" value="Y" />

 

 

There is a site that will help test Paypal transactions.

 

http://www.belahost.com/pp/

 

In order to use that site you have to make a change to the “PostMode” variable in the adminpanel to “test” mode.

 

 

The module “module-paypal_1t.php” is for OneTime Payment. It will still go by your “Dealer Membership” setting but will post to Paypal as an item, not a subscription. This allows the user to buy a subscription but not have the renewal offered by the subscription service of Paypal. It is recommend using one or the other, either the OneTime Payment or the regular Paypal subscription payment module. Disable the other if not in use.

 

For debug purposes it is required that you chmod the modules/tmp folder to 777 (full writable permissions) The debug procedure will email you and write a file. The email and file will contain the same information and this includes all queries and variables submitted. File option is only for the paypal module at this time.

 

 

Sponsors:

 

     The sponsor section is pretty easy to understand. It is not related to any user so you are able to add a sponsor at any given time. You add the clicks and make it disabled or enabled. This also lets you edit and view other users sponsored ads as well.

 

 

 

Users:

 

Buyers:

 

     If you set up the system to have Buyers Pending then this is the place to view the buyer info. Althought buyers are free to signup it could also be set up to check the buyer information before they becomes active. A buyer cannot be a seller or dealer unless made by you the admin.

 

Adding a buyer is simple. Fill in the info in the “Add a user” page. Then select the appropriate type for that user.

 

Searching for a member: click “search for a user” will bring up a page so you can select which part to search by. You can search by name, email, userID, date joined, active and ID. Click on find will show the results of your search.

 

Buyers are only allowed to buy Sponsorships, not any car listings.

 

Sellers:

 

     Sellers can list car listings by purchasing listing credits. They cannot subscribe to the site; only purchase a listing to add the car.

 

 

Dealers:

 

     These dealers are the ones to purchase a monthly membership if you have it set to do so. You are welcome to add a dealer as you see fit from the admin. Just click on the “Add an User” link on the side and fill out the form. You can also set up to where the Dealer can subscribe or just purchase by month or year. Memberships can be recurring or non-recurring if you have it set to be that way. Non-recurring means that if they purchase for a 3 month period that is all they get, once the time is up in that 3 month period they become disabled and not allowed to add anymore listings until they pay for another membership. A Recurring membership is if they purchased a 3-month membership then at the end of the 3 months it will renew automatically (Only works with Paypal). Others payment processors are generally a one time payment only. The dealer will have the option to purchase a onetime payment or a recurring subscription if you enabled these in the modules section.

 

Setting up dealer subscriptions is fairly easy. Click on the link that says “Dealer Subscription” on the left hand side. Once this page is open just click on the Add a new row to make a new subscription plan.

 

Order: To list them how you want when the user is signing up.

Enabled: Enabled will show on the site, disabled it will not show on site.

Length: The length of the subscription, 1-12 depending on what Term is set at.

Term: Will it be a month or year. Depends on what length is set at.

Price: How much it will cost for this subscription: be it a month or year.

 

 

 

 

System Info:

 

     This section lists the action to be taken with the signup of a owner or buyer. Also it will let you decide if the property to be added will be active or pending. Pending lets you check for the property or owner/buyer to see if it is legit. Did they pay for the membership with valid credentials? This is for your discretion and totally left up to you.

 

Car Listing – Sets up whether New Car Listings are set to pending for your review before setting live, or active where they go straight into active.

Dealer Activation - Sets up whether New dealers are set to pending for your review before setting live, or active where they go straight into active after purchase.

 

Dealer Signup – Sets new dealer signups to be free or paid subscription. This relies on Dealer Activation whether it is pending or active.

 

Dealer Subscription – Sets the option to have new dealers subscribe on a recurring basis or a non-recurring (pay once mode).

 

Debug - Sends debug emails to your email address you supplied in the config file. Lets you check to see if all variables are getting filled out correctly.

 

Display Poll – If you want the poll to be active on the site enable this, otherwise disabled it.

 

PostMode –Allows you to check the functionality of the Paypal module, it only works for Paypal.

 

Security Image – Once enabled it will how a image with letters and numbers for the user to enter before they signup. Basically used to stop/slow down spam bots and search engines form signing up unreal users.

 

Seller Activation - Sets up whether New dealers are set to pending for your review before setting live, or active where they go straight into active after purchase.

 

 

Seller Listing Length – Sets how long each car listing the seller adds will stay live on the site once approved.

Seller Price – How much it will cost per car listing when the seller purchases a listing.

 

Seller Signup - Sets new seller signups to be free or paid subscription. This relies on Seller Activation whether it is pending or active. If set to free then the seller can list as many listings as they want.

 

Sponsor Activation – Sets the new added sponsor to active or pending for admin review.

Sponsor Clicks – Sets how many clicks they are to purchase. The user has the ability to pick how much they want at purchase time.

Sponsor limit – Sets the default limit of how many sponsors to show on the page. Default to 5

Sponsor Price – Sets the base price per Sponsor Clicks the user is able to purchase.

 

 

 

Admin:

 

     This option allows you to add a new admin or view admin already installed. This is to allow more than one person to access the admin side of things for checking pending status or do administration stuff. Very important to remember, once you add a new member they will be allowed to delete your account and take over so to speak. So make sure you are very trusting to this member/person.

 

 

 

Approving:

 

     This is pretty important. In this section you need to be able to judge what is true and what is false with your records from Paypal or Worldpay or 2Checkout. This lists what they bought and who they are, it is up to you to judge the authentication of each transaction. Pending is only setup if you enabled it in the system info page.

 

 

Upgrades:

 

     Upgrades are really simple. To upgrade your copy just download the latest release, upload all files in the upgrade folder to the root of the Script install. Run upgrade/upgrade.php and step through the upgrade process. After the update is done please upload all files that have been changed according to the change.log file to their respected folders.

 

     After the upgrade is done and you login to the admin you will see a newely added link on the front page. This links tells you that templates have been modified for the new upgrade that just taken place. Clicking this link will show you all of the templates that have changed and what version they we last changed in. If you have not edited any templates it will be safe to “Revert” the template to the new changes. If you did alter any of the templates then you have to load “edit” each template and find the difference between the two. I cannot tell you what the differences are as it is up to you. Support will not help either. The endless changes to the templates will be very hard to track so asking support for help will be a troublesome task. If you are unsure of what changes have taken place then you shouldn’t have edited the template in the first place.

 

 

 

Support:

 

If you have found a bug or something is not correct about the install or if you just have a question, please feel free to contact us at

 

 

Please have the following items ready when you contact us.

 

1)  The Operating System the site is hosted on (Windows, Linux/Unix)

2)  The pinfo.php page suggested earlier in this readme.

3)  What Script you installed

4)  The URL that you have installed it at.

5)  Your user id.