Real Estate php/mySQL Listings Directory script, php, sql

  Home | News | Requirements | Features | Demo | Purchase | Community | Mods | Guide | Contact

PHPMYREALTY USER'S GUIDE

Thank you for choosing phpMyRealty - the Real Estate php/SQL web application. Please, read the following guide carefully to understand the basics of PMR installation/administration.

Contents:

I. Script Installation and Post Installation Tasks

1. Installation

    a. Requirements
    b. Installation

2. Post Installation Tasks

    a. Languages
    b. Templates
    c. Web Configuration Panel

II. Administrator's Guide

1. Managing Administrators

    a. Adding/Editing/Removing Administrators
    b. Setting Administrator's Permissions

2. System Configuration

    a. Web Configuration Panel
    b. Ban e-mails
    c. Statistics
    d. Database Backup

3. Managing Types, Locations etc.

4. Managing Agents / Users

    a. Approving New/Updated Agents
    b. Adding New Agent
    c. Updating / Removing Agent

5. Managing Listings

    a. Approving New/Updated Listings
    b. Adding New Listing
    c. Updating / Removing Listing
    d. Photo Gallery Management
    e. Featured Listings
    f. Featured Agents
    g. 2checkout Account Configuration

III. End User License Agreement (EULA)

I. Script Installation and Post Installation Tasks.

1. Installation.

a. Requirements.

PMR was written to use php scripting language and mysql database as a backend. These are multiplatform applications and this makes PMR a multiplatform web application too. It can run on unix or windows servers, the main requirements to install PMR are:
  • FTP access - ftp access is needed to upload the script to your host via ftp protocol, sure you can unzip the script into the folder directly on your server if you have ssh access or have direct access to the console. You can use any ftp client you like, there are several things you need to know while installing the script, you can find these in the Installation part of the User's Guide;
  • PHP - php scripting language, version 4.3 or newer. Sure it will run on older versions, but to be sure about the security and stability of your application we recommend the latest version of php to be installed (please note that development versions of php may have some serious bugs, please, do not use those for production servers);
  • mySQL - mySQL database server and php module to support mySQL installed and configured on your host;
  • GD2 - GD2 graphic library to be compiled into your php installation, if you don't have it ask your hosting provider, this is the most common module installed for php;
  • mod_rewrite - mod_rewrite is an Apache module which is useful for rewriting URLs, something like changing .php extension to .html for better SEO. This module is optional, the script can operate well without this.
  • IonCube Loader - Required. We use IonCube encoder to encode some of the code. Most of the script is open.

b. Installation.

PMR is very easy to install. First you will need to unZIP the package you received via email after purchasing. Then upload the files to your webserver, you will need ftp client appliacation to do that. Transfer php scripts as text and images as binary files (most of the modern clients process the file types automatically).

After you have the files and folders uploaded you need to change some folders permissions. The folders to change are:

/banners
/gallery
/images
/photos
/video

Please, change permissions to chmod 777 or rwxrwxrwx, this will allow the php user to read/write these folders. Usually there is no need to change the permissions on the windows hosting.

You will also need to change the permission of /locations.txt to rw-rw-rw-.

After you have the above things done you need to edit the main configuration file - config.php which is located in the script root folder. It includes the most important script configuration settings which can not be controlled via web based configuration panel for the security purposes.

The settings to change are mysql database details and the URL and your PMR root folder on the server. E.g:

// mySQL DATABASE DETAILS

$dbi['sql_username'] = 'pmr'; // Database username
$dbi['sql_password'] = 'password'; // Database password
$dbi['sql_host'] = 'localhost'; // Database host
$dbi['sql_dbname'] = 'data'; // Database name

// PATHs

// URL to your script root folder (do not use trailing slash)
define('URL' , 'http://www.phpmyrealty.com/script');

$install_folder = '/script';

Another setting to edit in the config.php file is your license number, you will get it after your purchase. Please note that you will have to send the PMR support your hosting IP and domain name to get the license ID.

You can install PMR into a new database or use an existing one and share the database with other applications.

If you are going to run several copies of PMR in one database all you need to change is the database table prefix in config.php file - unique for each installation, this will allow you to do the unlimited number of installations using only one database.

The next step is to create the database tables, to do this simply run /install/install.php script, e.g. http://server.local/script/install/install.php - this will create and populate the initial database. If all the tables were created successfully you can remove the /install filder from the host or check your database settings in config.php if the tables creation failed.

The next step is to run the script, just open the URL you set in config.php in your browser. If no errors reported you can press the Administrator link and login to your super administrator account using login: admin, password: admin. When in admin you can change your super administrator password and change the configuration of the script using the Web Configuration Panel.

The other thing to edit in the Configuration Panel is your Google Maps Key, you can obtain it from here: http://www.google.com/apis/maps/signup.html

Actually this is all you need to know to install and run the script for the first time.

If you are UPGRADING from the previous versions please, make sure to backup your scripts and database before doing anything, this is the most important - not to lose your data. The upgrade instructions are usually provided with the upgrading package.

2. Post Installation Tasks

After you have installed the PMR script onto your server you can customize it to suit your needs. PMR is a multi-template and multi-language script this means each visitor can select the language or template he/she wants to use and it will be remembered in the user cookies to be used during next visits to your website.

a. Languages.

Language files are stored in the /languages folder. These are simple php files which include a lot of variables. They are easy to edit, just some amateur knowledge of php syntax is required. If you want to add more languages for the users to choose from just create files based on the default one (english.lng.php) and name them like language.lng.php where "language" is a the name of the language. The other important thing when creating language files is a file codepage you used while created them, so make sure to edit texts in the codepage you are about to use with this language. It is important to use one and the same codepage for all the language files you use, so we recommend UTF-8 as the default codepage.

The language file variables are all quite easy to understand, lets see the most important ones:

// phpMyRealty codepage
$lang['Encoding'] = 'utf-8';

// Text Direction
$lang['Direction'] = 'ltr';

// Date Format
// Please, use "m" for month, "d" for day and "y" for year and
// delimit it with "-"
$lang['Date_Format'] = 'm-d-y';

the above variables control the codepage which is going to be used with this language, text direction and the date format used for this region.

If you want not english language to appear as default, just add new language file into the /languages folder as e.g arabic.lng.php and change Default Language in your administrator Web Configuration Panel to 'arabic'.

b. Templates.

PMR allows several templates to be used on one site so users can select the template they want. Templates are stored in the /templates folder as folders. Lets see the /default template - a default one.

PMR templates usually include the following files:

  • header.php - a general header file for all the pages, it includes all the required meta tags, css and JavaScripts which have to be duplicated into all the new templates. This is a good example of how to create new templates.

  • footer.php - a general footer for all the pages. If you create a new template, please, make sure to add all the required php code like in the default one.

  • style.css - default css file, it includes some classes which cannot be removed, so please, if you create a new template use this css sheet as a default and just change or add new classes and do not remove the default ones.

  • menu.php - default menu module links set. You can add new links into the menu by editing this file, a standard link to add is e.g

    echo '<li> <a href="' . URL . '/file.php">Menu Item</a><br><br>';

    please make sure to include this code into the <ul> ... </ul> tags of the menu.php file. Do not remove or change the existing menu items, most of them are important for the script.

  • searchform.php - this file controls the Search module you can see on all the pages on the left (for the default template). You can add/remove fields, change the way the form is presented by editing this file. It is mostly php based, but quite easy to understand.

  • searchform2.php - this file controls the Search module on the top search of the home page (index.php).

  • tables.php - this script is used to set header and footer for all the tables in the script. These are side boxes and the central frame tables. With this script you can add rounded corners, borders, shades to your central frame table and the side boxes.

    There is also /images folder which is used to store the template images, to call the image in the template you have to use the following link:

    <img src="<?php echo URL . '/templates/' . $cookie_template . '/images/image.gif'; ?>" alt="0" border="0">

    To control the way listing and agents are presented you can edit the tpl files located in the /tpl folder.

  • gallery.tpl - controls the way gallery images are printed, this is a cell of the html table, no php knowledge required to change this, you can use the following variables in this file:

    • {new} - will print a red square with the 'NEW' mark if this gallery image was added recently (there is a setting in the configuration panel for this)
    • {updated} - will print an 'UPDATED' mark near the image if the image was updated recently.
    • {image} - prints the image which is clickable (a full-size image will appear in the new window)
    • {name} - title of this image
    • {description} - description of this image
    • {date_added} - date when image was added
    • {date_updated} - date when image was updated

  • property_detailed.tpl - controls the look of the property detailed information page. A simple html table, the variables to edit:

    • {new} - please, see above gallery.tpl for description
    • {updated}
    • {featured}
    • {link} - generates an URL to the listing
    • {slideshow} - generate a slide show using the Photo Gallery images
    • {image} - shows the clickable main image of the listing (will open full-size image in a new window)
    • {mls} - MLS number
    • {title} - Listing title
    • {type} - Property type
    • {type2} - Listing type (sell, rent, buy)
    • {video} - Video Tour Link (for detailed page only)
    • {pdf} - PDF Link (for detailed page only)
    • {style} - Listing Style
    • {description} - Listing Description
    • {lot_size} - Lot Size
    • {dimensions} - Dimensions
    • {bathrooms} - Number of bathrooms
    • {half_bathrooms} - Number of half bathrooms
    • {bedrooms} - Number of bedrooms
    • {location} - State/Province
    • {city} - City
    • {address1} - Address Line 1
    • {address2} - Address Line 2
    • {price} - Lot Price
    • {currency} - Currency Name
    • {directions} - Directions
    • {year_built} - Year Built
    • {agent_commision} - Agent Commision
    • {winter_tax} - Winter Tax
    • {summer_tax} - Summer Tax
    • {buildings} - Additional Out Buildings
    • {appliances} - Appliances Included
    • {features} - Features list
    • {garage} - Garage Type
    • {garage_cars} - Number of cars
    • {basement} - Basement type
    • {view_realtor} - A link to the agent detailed information page
    • {map} - A link to the google map
    • {friend} - Mail to a friend link
    • {date_added} - Date when the listing was added
    • {date_updated} - Date when the listing was updated
    • {ip_added} - IP of the user who added the listing
    • {ip_updated} - IP of the user who updated this listing for the last time
    • {hits} - Number of visitors to this listing

  • property_search.tpl - used to show the table cell with the short listing details in the search results, the variables to edit are similar to property_detailed.php.

  • realtor_detailed.tpl - shows the detailed information page of the agent, a simple html table, easy to edit, the variables are:

    • {new}
    • {updated}
    • {top} - print 'TOP' mark near the listing if it has 4.5 rating with at least 5 votes.
    • {photo} - agent clickable photo (opens a full-size image in a new window)
    • {first_name} - First Name
    • {last_name} - Last Name
    • {company_name} - Company Name
    • {description} - Agent Description
    • {location} - Agent State/Province
    • {city} - City
    • {address} - Address
    • {zip} - Zip Code
    • {phone} - Phone Number
    • {fax} - Fax
    • {mobile} - Cell Number
    • {email} - email
    • {website} - Website
    • {view_user_listings} - Shows clickable list of agent's listings
    • {map} - google map
    • {date_added}
    • {date_updated}
    • {ip_added}
    • {ip_updated}
    • {hits}

  • realtor_search_short.tpl - a short agent details for the search table, uses the same variables as realtor_detailed.tpl

    Please note, that you can also print the name of the variable, for example to print the word 'City' in the tpl you will have to add {@city} variable, so add @ before each variable name to print the variable name and not the value, e.g:

    {@city}: {city}

    will print:

    City: New York

c. Web Configuration Panel.

Web Configuration panel is used to configure your script without editing text files. The data is stored in mysql table which makes the script work faster. To get to the Panel you will need to login as super-administrator or as an administrator who have access to configuration.

The Panel is located in Administrator -> Configuration Settings -> Configuration Settings

You can find the variables descriptions right in the form, so there is no need to describe them here.

II. Administrator's Guide.

1. Managing Administrators.


a. Adding / Editing / Removing Administrators.

PMR is a multi-administrator system, this means there is a way to have an unlimited number of administrators with different privileges. There is a super-user account you cannot remove but can change login and password right after installing the system or as a periodical safety measures.

You can access the Administrators Management scripts in your Administrative Section -> Manage Administrators submenu. There are two options to Edit Existing Administrators and Set Privileges. To add new administrator with the desired privileges you will need to click the 'Edit Administrators' submenu, and put a new username and password in the 'Add' subtable. Please, also remember to select a privilege for this administrator, if no privileges are in the list you will have to add one. Please note that new administrators cannot be added without the privilege. Read the next chapter to learn how to Add Privileges.


b. Setting Administrator's Permissions (Privileges).

Before adding new administrators to the fresh installation you will have to add a privilege for an administrator or a group of administrators.

To add a privilege, simply go to Administrative Section -> Manage Administrators -> Edit Privileges submenu. You'll be presented with a form which contain a privilege name and the possible options you can allow for this privilege.

To submit a new privilege please put a privilege name in the Submit Privilege form and select the options you want this admin to have enabled. It is possible to select several options. The possible options are:
  • Can Manage Users - allow the administrator to login and have access to the 'Manage Users' menu and all the submenus (Approve New Users, Check Updated Users, Add New User, Update/Remove Users, Send Messages)
  • Can Manage Listings - allow the administrator to login and have access to the 'Manage Listings' menu and all the submenus (Approve New Listings, Check Updated Listings, Edit Listings)
  • Can Manage Photo Gallery - allow to edit the Photo Gallery for each listing, please, use this option with the 'Can Manage Listings' option.
  • Can Manage Types, Locations etc - allow the administrator to login and edit the database content using the submenus located in the 'Manage Types, Locations etc.' menu (Edit Porperty Type, Edit Styles, Edit Locations, Edit Additional Out Buildings, Edit Appliances Included, Edit Features, Edit Basement Types, Edit Garage Types).
  • Can Manage Configuration Settings - allow the administrator to access 'Configuration Settings' menu and it's submenus (Configuration Settings, Database Backup, Ban e-mail Addresses, Statistics).
  • Can Manage Administrators - allow this administrator to add/remove administrators and privileges, can access 'Manage Administrators' menu and 'Edit Administrators', 'Edit Privileges' submenus.

After adding a privilege you can use it by adding a new administrator into the system via 'Edit Administrators' submenu.

When a new administrator access the system he/she will be presented with the available options, all other menus will be hidden.


2. System Configuration.


a. Web Configuration Panel.

Web Configuration panel is used to configure your script without editing text configuration files. The data is stored in mysql table which makes the script work faster. To get to the Panel you will need to login as super-administrator or as an administrator who have access to 'Configuration Settings'.

The Panel is located in Administrator -> Configuration Settings -> Configuration Settings

You can find the variable descriptions right in the form, so there is no need to describe them here.

b. Ban e-mails.

It is possible to deny new user submissions if the definite email was specified. You can use Configuration Settings -> Ban e-mail Addresses menu for this. The interface is simple, to add new email to be blocked just insert the email into the text field and press 'Add', to update existing e-mail just specify a new one in the field, choose the e-mail to edit using the radio button and press 'Update', to remove the block for the definite email just select it using a radio button and press 'Remove'.

Initially there was an idea to ban domains if *@domain.com mask is specified, but this may cause some serious limitations for other possible users of this domain, so it was decided to leave it as is.

c. Statistics.

You can view the simple statistics page by visiting Configuration Settings -> Statistics. Some simple options are available. Please, see image for the sample script output.


d. Database Backup.

To create sql compatible database backup please use Configurations Settings -> Database Backup. This will save the database structure and all the data located in the current database for the backup purposes, you can restore this dump later if needed using phpMyAdmin tool or any other mySQL client.

The file is generated right after you press the 'Database Backup' icon. The generated file have the following name: DATABASE_NAME-YYYY-MM-DD.sql where YYYY-MM-DD is a current date.

3. Managing Types, Locations etc.

You can edit some database tables content using 'Manage Types, Locations etc' menu in your Administrative Section. The possible options to edit are:
  • Edit Property Types - to add/edit 'Property Types', please, do not remove existing property types if there are listings in them, this will corrupt the database integrity.
  • Edit Styles - to add/edit 'Styles' for the listings, please, do not remove existing types if there are listings which use these styles, this may corrupt the database integrity.
  • Edit Locations - this submenu allows the administrator to edit 'State / Province' used for the listings and agents. Please, do not remove existing items which may be used by the listings or agents.
  • Edit Additional Out Buildings - this option let you add/remove 'Additional Out Buildings' options.
  • Edit Appliances Included - use this submenu to edit the 'Appliances Included' options.
  • Edit Features - use this submenu to edit the 'Features' options for the listings.
  • Edit Basement Types - use this submenu to edit the 'Basement Types' options for the listings.
  • Edit Garage Types - use this submenu to edit the 'Garage Types' options for the listings.
The interface to add/edit the above options is pretty simple. To add a new option just select the submenu to edit, put an item name into the text field and press 'Add', to update an existing item just put a new item name into the text field, choose an item to update using a radio button and press 'Update', to remove an item, just select the item to remove using radio button and press 'Remove' button.

4. Managing Agents / Users.


a. Approving New/Updated Agents.

If you have configured the script to let you approve all new/updated user submissions you will need the following submenu to check all the new users and users updated for the last 5 days. Please note that new submissions are not available in the public directory until approved by the administrator.

The new submissions approval tool is accessible via Manage Users -> Approve New Users submenu. You are presented with a list of all new submissions waiting for the approval. Just check the listing by pressing the 'Edit' link on the right, you can even do some corrections, then return back to the list by pressing the 'Back to latest agents search results' link and press 'Approve' link to approve the listing, if you do not want this listing to be added simply remove it by pressing the 'Remove' link.

You can also check the updated listings, if you press Manage Users -> Check Updated Users you get the list of all the agents updated during last 5 days. You can edit or remove them the same way you do when approving new submissions. If you want to see listing updated during a diffirent period of days you can use the search form located in the bottom of the page. Please note that updated agents are still available in the public directory and are not hidden until you check them.


b. Adding New Agent.

If you have privileges to manage users you can add a new agent (user) into the system. To do this click Manage Users -> Add New User submenu. You'll be presented with a simple form to submit a new user. It is the same form you can find in the user section. Just specify all the required data and press 'Submit Agent' button. If there were errors found during processing you'll get the list of these errors and the form with the previously submitted data to correct.

To add a agent photo you will need to use Manage Users -> Update/Remove Users submenu to edit the listing you have recently added, there is an option to upload the photo there, just press 'Edit' link near the user to edit.

c. Updating / Removing Agent.

You can update any user stored in the database if you have privilege to do this. Simply press Manage Users -> Update/Remove Users submenu. You will be presented with the search form to look for the user you want to edit, please, be specific not to fetch too many listings, as this may cause some navigation problems for novice users when editing the listings.

After you have searched for the user listings you can edit each listing by pressing the 'Edit' link located near the desired agent. You can also 'Remove' any listing you want. Please, note that if you are removing the listing, all the data connected to that listing will be removed (images, listings, photo gallery).

To upload the agent photo you will need to press 'Edit' link near the agent you want to add photo to. Then use agent Logo/Photo form to do that. Press 'Browse...' button and select the JPEG image you want to upload, please note that the image will be resized according to the setting in the configuration settings (photo_resampled_width). There is also an image size limitation set in the configuration settings (max_photo_width, max_photo_height) and the image file size limitation (max_photo_size).

5. Managing Listings.


a. Approving New/Updated Listings.

If you have configured the script to let you approve all new/updated listing submissions you will need the following submenu to check all the new listings and listings updated for the last 5 days. Please note that new submissions are not available in the public directory until approved by the administrator.

The new submissions approval tool is accessible via Manage Listings -> Approve New Listings submenu. You are presented with a list of all new submissions waiting for the approval. Just check the listing by pressing the 'Edit' link on the right, you can even do some corrections, then return back to the list by pressing the 'Back to latest listings search results' link and press 'Approve' link to approve the listing, if you do not want this listing to be added simply remove it by pressing the 'Remove' link.

You can also check the updated listings, if you press Manage Listings -> Check Updated Listings you are presented with the list of all the listings updated during last 5 days. You can edit or remove them the same way you do when approving new submissions. If you want to see listings updated during a diffirent period of days you can use the search form located in the bottom of the page, the options to control this can be seen on the following picture. Please note that updated listings are still available in the public directory and are not hidden until you check them.

b. Adding New Listing.

If you have privileges to manage listings you can add a new listing into the system. To do this click Manage Users -> Update/Remove Users -> (Find the user you want to add listing to using the search form in the bottom) -> Press 'Add New Listing' link near the user you want to add the listing to.. You'll be presented with a simple form to submit a new listing. It is the same form you can find in the user section. Just specify all the required data and press 'Submit Listing' button. If there were errors found during processing you'll be presented with the list of these errors and the form with the previously submitted data to correct.

To add a listing main photo you will need to use Manage Listings -> Update/Remove Listings submenu to edit the listing you have recently added, there is an option to upload the photo there, just press 'Edit' link near the listing to edit.

c. Updating / Removing Listing.

You can update any listing stored in the database if you have privilege to do this. Simply press Manage Listings -> Edit Listings submenu. You will be presented with the search form to look for the listing you want to edit, please, be specific not to fetch too many listings, as this may cause some navigation problems for novice users when editing the listings.

You can also get the list of all the listings for a definite agent by using the following scheme Manage Users -> Update/Remove Users -> (find the required user to add listings to using the simple search form) -> Press 'Edit Listings' link near the agent. This way you will get a list of all the listings for the current agent. Please note that this scheme is only available if the administrator have 'Can Manage Users' privilege.

After you have searched for the listings you want to edit you can edit each listing by pressing the 'Edit' link near each one. You can also 'Remove' any listing you want. Please, note that if you are removing the listing, all the data connected to that listing will be removed (images, photo gallery).

To upload the listing main photo you will need to press 'Edit' link near the listing you want to add photo to. Then use Image Upload form to do that. Press 'Browse...' button and select the JPEG image you want to upload, please note that the image will be resized according to the setting in the configuration settings (image_resampled_width). There is also an image size limitation set in the configuration settings (max_image_width, max_image_height) and the image file size limitation (max_image_size).

d. Photo Gallery Management.

The Photo Gallery feature is used to store JPEG images for the listings. This part of the PMR script can be accessed for the administrators who have privilege to do this (Can Manage Photo Gallery).

To get to the Photo Gallery editor for the definite listing you have to navigate the administrator section using the following scheme: Manage Listings -> Edit Listings -> (find the listing to edit in the search form) -> Press 'Photo Gallery' link to get to the Photo Gallery for this listing.

The Photo Gallery interface is quite simple. It consists of a list of images each with a radio button for you to select the image you want to update or remove and a form to upload text data (Submit Photo Information) and upload image.

To update the text data, simply select the gallery item to update using the radio button, put some new text into the 'Submit Photo Information' form and press 'Update Photo Information' button. This will also substitute the existing image with the new one.

To remove the gallery item just select this item in the list using the radio buttonand press 'Remove Photo Information' button.

Please note that the uploaded images are resized according to the setting in the configuration settings (gallery_resampled_width). There is also an image size limitation set in the configuration settings (max_gallery_width, max_gallery_height) and the image file size limitation (max_gallery_size).

Users can also use Bulk Photo Upload tool to upload multiple images at once.

e. Featured Listings.

There is a possibility to make some of the listings featured. This allows them to appear first in the search results and to be visible in the 'Featured Listings' module on the home page.

To make the listing featured you have to set the Featured Packages in the Configuration Settings menu, the package consists of Package Name, Package Duration (in days) and Package Price, the price currency is set in the Configuration Settings Web Panel. Please, make sure to add your paypal primary email in the configuration settings and enable IPN in your paypal account. The featured package can be set in the Administrative section only when adding new listing or editing the existing one.

Users will have to press the package name when editing their listings to pay for the featured package via paypal.

This a separate featured listings packages system and is not connected to the featured agents system.

NOTE! Please note that if agent package expires or agent reupgrades to a package which has less listings available he currently has, all listings including featured listings are removed.

f. Featured Agents.

It is possible to have agents pay for their accounts and let them have an ability to store a definite number of listings, photo gallery images per listing and have their address, photo and phone numbers visible in the directory.

When agent submits his details he receives a free listing. He can upgrade right after submitting his listing, this way his agent record is approved automatically.

When user upgrades to a definite package he gets an ability to post listings, the number of listings is controled for each package individually. Administrator can add an unlimited number of packages with a different number of listings, photo images and other settings.

The package duration in days is also set for each package indivudually. This is a number of days the user can have his listings available. Before the record expire the agent is notified by email and have to login and upgrade his agent record again not to lose his listings, photos and contact information. If the agent listing expires it gets free package automatically.

If agent reupgrades to a package with more listings available his old listings are not removed, but if he reupgrades to the package with a smaller number of listings available his old listings are removed, even if those listings are featured.

Administrator can change agent's package any time by editing the agent record and setting the required package name in the drop down menu.

Administrator can also set the featured package while approving the free listing, this way administrator can let his new users upgrade for free for a definite package just in case of a promo or if this website is free for all agents.

Administrator can also change the settings for the FREE package to let agents post free listings for free.

g. 2checkout Account Configuration.

For users with the vendor id < 200000 Go to 'Account Details', then to 'Return' submenu. Here in 'purchase.2c Passback Parameters' set 'Return to a routine on your site after credit card processed?' to 'YES' and insert the full url to 2checkout.php like http://www.phpmyrealty.com/demo/2checkout.php into 'Return URL'. In 'Overall Passback Parameters' set 'Direct Return' to 'YES' and specify a secret word to secure your transactions. After this in 'Account Details' menu choose 'Sales Parameters' submenu and set 'Accept Check Payments' to 'No'. And change 'Put Purchase Button/Link Routine in Demo Mode?' to 'No'.

For users with the vendor id > 200000 Go to '7. Setting Up Your Site.', then in the Optional Parameters paragraph choose 'Check Here' link. Please, set the following variables here : 'Input a url for your customers to be sent to on a sucessful purchase', this has to point to your 2checkout.php file located in the PMR root folder and specify a secret word to secure your transactions.

You will need to create a product in your 2co account according to the product your have in your packages (agent packages and listing packages, there is a field to place a 2co product ID when you add package in your admin area). To change the gateway to 2co set 'gateway' variable in your PMR Administrator Configuration Panel to '2', for PayPal set it to '1' (default).

Attention! All users with the vendor id < 200000 will have to change the 2checkout payment gateway in your Administrator Configuration Setting Panel to "https://www.2checkout.com/cgi-bin/sbuyers/purchase.2c".

III. PHPMYREALTY END-USER LICENSE AGREEMENT

NOTICE TO USERS: PLEASE READ CAREFULLY THE FOLLOWING LEGAL AGREEMENT. USE OF THE PHPMYREALTY.COM SCRIPT PROVIDED WITH THIS AGREEMENT (THE "SCRIPT") CONSTITUTES YOUR ACCEPTANCE OF THESE TERMS. IF YOU DO NOT AGREE TO THE TERMS OF THIS AGREEMENT, DO NOT INSTALL AND DO NOT USE THIS SCRIPT. USER'S USE OF THIS SCRIPT IS CONDITIONED UPON COMPLIANCE BY USER WITH THE TERMS OF THIS AGREEMENT.

LICENSE GRANT. "You" means the company, entity or individual whose funds are used to pay the license fee. "Use" means storing, loading, installing, executing or displaying the SCRIPT. phpMyRealty.com grants you a non-exclusive license to use one copy of this script on your host/website with the IP address which is recorded in your license. The output of one copy of the script can be used solely on the website on which the copy is installed. You can make one copy of the Software in machine-readable form for backup purposes only. You can modify the SCRIPT for your personal use only and to the extend that all copyright notice and license reference are kept unchanged. You cannot disable any licensing or control features of the SCRIPT except as an intended part of the SCRIPT's programming features. Please, acknowledge that phpMyRealty.com may not be able to provide support or future upgrades if you make modifications to the internal code of the system. This license is not transferable to any other website or other company, entity, or individual without phpMyRealty.com written permission.

OWNERSHIP. The SCRIPT is owned and copyrighted by phpMyRealty.com. Your license confers no title or ownership in the SCRIPT and should not be construed as a sale of any right in the SCRIPT.

COPYRIGHT. You acknowledge that no title to the intellectual property in the SCRIPT is transferred to you. You further acknowledge that title and full ownership rights to the SCRIPT will remain the exclusive property of phpMyRealty.com and you will not acquire any rights to the SCRIPT except as expressly set forth in this license. You agree that any copies of the SCRIPT will contain the same proprietary notices which appear on and in the SCRIPT.

PROPRIETARY MARKINGS. phpMyRealty.com logos, product names, manuals, documentation, and other support materials are either patented, copyrighted, trademarked, constitute valuable trade secrets (whether or not any portion of them may be copyrighted or patented) or are otherwise proprietary to phpMyRealty.com. You shall not remove or obscure phpMyRealty.com copyright, trade mark or other proprietary notices from any of the materials contained in this package or downloaded together with the Software.

UNAUTHORIZED USE. You may not sell, rent, lease, decompile the encrypted code or transfer the SCRIPT, the ouput generated by the SCRIPT, a modifed SCRIPT based on THE SCRIPT on or the output of a modified SCRIPT based on the SCRIPT except as provided in this agreement. Any such unauthorized use shall result in immediate and automatic termination of this license.

LIMITED WARRANTY. THIS SCRIPT IS PROVIDED ON AN "AS IS" BASIS. phpMyRealty.com DISCLAIMS ALL WARRANTIES RELATING TO THIS SCRIPT, WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. phpMyRealty.com SHALL NOT BE LIABLE FOR ANY INDIRECT, CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE SUCH SCRIPT, EVEN IF phpMyRealty.com HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. THE PERSON USING THE SCRIPT BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE SCRIPT. SOME JURISDICTIONS DO NOT ALLOW LIMITATION OR EXCLUSION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATIONS OR EXCLUSION MAY NOT APPLY TO YOU TO THE EXTENT THAT LIABILITY IS BY LAW INCAPABLE OF EXCLUSION OR RESTRICTION. IN NO EVENT SHALL ANY THEORY OF LIABILITY EXCEED THE LICENSE FEE PAID TO phpMyRealty.com.

ENTIRE AGREEMENT. This is the entire agreement between you and phpMyRealty.com which supersedes any prior agreement or understanding, whether written or oral, relating to the subject matter of this license.

RESERVED RIGHTS. All rights not expressly granted here are reserved to phpMyRealty.com.




Testimonials

Probably the best Real Estate script on the web. Very inclusive, well written, easily customizable and with the best support I have ever seen. Do not look any further, get this one with your eyes closed. You will be surprised!

Fotis Tsintzas,
houses-of-greece.com


©2005-2008 phpMyRealty.com

Valid HTML 4.01 Transitional Valid CSS!