| I. Step 1 - Change Settings |
|---|
After you unzip the plugin .zip file, open up the ./vsreal/settings/password.php file and change the password to something more secure.
Then open the ./vsreal/settings/settings.inc.php file and change the contact information appropriately. |
| back to top |
| II. Step 2 - Upload vsREAL files |
|---|
| Use your favorite ftp program (or at least whichever one you have access to) to upload the ./vsreal directory (the plugin) to your public html directory. You don't need to upload this instruction file or the template file (vsrealdemo.html). |
| back to top |
| III. Step 3 - If necessary, change permissions |
|---|
If you have a unix/linux host, you will need to change the following permissions so that your listings can be saved.
[file] -> [permission]
./listings (directory) -> 777
./listings/listingnumber.txt -> 777
Some hosts have have a box for permissions that looks something like this:
If this is the case with your host, make sure all the boxes are checked for the ./listings directory and the listingnumber.txt file. |
| back to top |
| IV. Step 4 - Integrate vsREAL with website |
|---|
There are two ways to integrate vsreal into your website.
- The "include" method.
- The IFrame Method.
The "include" method
Create a space in your html document where you want the listings to appear. This will most likely be inside a table cell <td>HERE</td> or div tags <div>HERE</div>
You should specify a width for the table cell or div, because the litings will take as much horizontal space as you give them.
Examples:
<td width='500'><?php include "./vsreal/vsreal.php"; ?></td>
<div name='list' id='list'><?php include "./vsreal/vsreal.php"; ?></div> and have the width controlled via css
The IFrame mehtod
Just put an iframe tag in your page where you want the plugin to be.
example:
<IFRAME height=500 width=600 SRC="./vsreal/index.php" TITLE="vsREAL" style="border-width:thin; border-style:solid">
<!-- Alternate content for non-supporting browsers -->
Your browser does not support iFrames
<a href="./vsreal/index.php"> click here</a>to see listings
</IFRAME>
The vsrealdemo.html file has an example of each as well.
|
| back to top |
| V. Step 5 - Manage Listings |
|---|
**********IMPORTANT**********
When you want to add/change/remove listings, go to:
www.yoursite.com/vsreal/index.php?page=manage
and enter your password.
|
| back to top |
| VI. Addendum 1 - Adding modified fields |
|---|
Changing and adding fileds to the lister is not difficult if you have any php knowledge.
To change the fields, you need to change the following files -
./pages/mNewListing.php
./pages/mEditListing.php
./inc/setlistingvals.inc.php
./inc/fill_fields.inc.php
./pages/showlisting.php
In the files, just look for where it says:
/* Add custom fields here. */
and use the example in the file as a template.
WARNING! the lister reads and writes the fields in order from a text file, so make sure the order of the fields is consistant across all of the above files. These modifications should probably be done BEFORE you upload the plugin to your website. Oh, yeah, and keep a backup, just in case.
|
| back to top |
| VII. Addendum 2 - Modifying the look |
|---|
If you want to modify the look of the lister, the first place to look is in the ./vsreal/css directory. There are two .css files there, one for the user-side pages(simple.css), and one for the manager-side(manage.css) pages.
The second place to look is in the user-side html.
There are two files that have the actual html code for your users, depending on which installation method you used. If you integrated with an iframe, the files are:
./pages/listings.php
./pages/showlisting.php
If you integrated with an "include" tag, the files are:
./pages/include_listings.php
./pages/include_showlisting.php
|
| back to top |
| VIII. Addendum 3 - Safe Mode errors |
|---|
Some hosts have their php running in Safe Mode. This can cause an errors when you are adding new listings. The easiest way to get the errors to stop and the script to work is to have your host turn off safe mode. If that is not an option, there is a fix included.
The files you need are in the safe_mode_fix directory that was included in the plugin zip file. If you have an older version that did not come with this folder, email me support_at_babykatiemedia.com and I will send you a copy.
To apply the fix:- open the ftpsettings.inc.php file in the safe_mode_fix folder with notepad or your other favorite text editor. Enter your ftp information in the correct places.
- Replace the addlisting.inc.php file and the deletelisting file in your ./vsreal/inc/ folder with the ones in your ./safe_mode_fix folder.
- Test your site to make sure the fix works
|
| back to top |
| IX. Contact |
|---|
If you have any questions, please contact:
support_AT_babykatiemedia.com
|
| back to top |
