File Name: FR-3.0.php FreeRealty documentation

Welcome to FreeRealty 3.0

Clean Install

    By far the 'easiest' install.
  1. Download the latest file from http://freerealty.rwcinc.net/download.php
  2. Change to the desired directory eg /var/www
  3. Unpack the file eg #unzip FR-3.0-0.rc6 will unpack to /var/www/FR-3.0-0.rc6/
  4. Set up the database. This involves creating the database and setting up a user/password combination.
  5. Decide whether you want your images in the database or in folders on the server
  6. Copy common30.sample.php to common.php
  7. Access install30.php

Upgrade a previous FreeRealty install

FreeRealty upgrades are incremental in nature. If you happen to start from th every beginning version of 2.6 you will need to do each upgrade in order. You should be able to upgrade from such older versions by using the upgrade scripts in the upgrades/ directory, but no guarantees can be made. Back up your database before attempting to upgrade from such older versions. An upgrade from version 2.9 should be fairly trivial:
  1. Backup your database and any script customizations
  2. Login to the upgrades/index.php page and follow the prompts in your browser
  3. Once the upgrade is done, rename or remove your common.php file, copy common30.sample.php to common.php and edit the database name, the user name, the password and table_prefix (if needed)
File Name: FR-2.9.php FreeRealty documentation

Welcome to FreeRealty 2.9

Beginning with version 2.8.4 additional documentation is being added in an attempt to make use of this project easier. Several different types of installations will be covered in this document. Since this is a fork of Jon Roig's version 2.6 OpenRealty
(here) we will first cover installing over the top of OpenRealty 2.6. If you are starting from scratch you can skip to the new install instructions
    Upgrade from OpenRealty 2.6- assuming a clean 2.6 install
  1. Use the upgrade scripts in /upgrades
    Several different scripts are available depending upon which version you are currently running. If you are upgrading from V 2.6 make sure to run the conversion scripts below for your thumbnail images.
  2. To use the new thumbnail features for previewing the homes you will need to convert the existing images in the db by running /upgrades/convert.php This file modifies the database by pulling images for each listing, creating a thumbnail view and inserting that back into the database. /upgrades/convert_agent.php should be run to convert the agent images and add the thumbnails.
  3. Files changed: Nearly every file has had changes, please consult the patch files to determine whether the changes are trivial for your installation.
  4. To have images saved to folders instead of the database, insert the following configuration items in common.php:
    $images_use = "folders";
    $imageloc = "images";
    Access and run /upgrades/exportimages.php
    Delete exportimages.php

Clean Install

    By far the 'easiest' install.
  1. Download the latest file from http://freerealty.rwcinc.net/download.php
  2. Change to the desired directory eg /var/www
  3. Unpack the file eg #unzip FR-2.9-pre3.zip will unpack to /var/www/FR-2.9-pre3/
  4. Set up the database. This involves creating the database and setting up a user/password combination.
  5. Decide whether you want to have your images in the web folders or in the database. There are two options: db or folders. Failing to set either "db" or "folders" in the common.php file will result in the database being used for images.
  6. Copy common.sample.php to common.php or run /install.php
  7. The install script will run and create your common.php if your installation directory is writable.
    If you need to set the directory as writable (temporarily) under *nix simply run chmod o+w /<installation directory>
    Access install.php
    Afterwards remove the world writable setting: chmod o-w /<installation directory>
  8. If you can't run install.php for some reason copy common.sample.php to common.php and edit common.php
  9. Delete upgrades/exportimages.php
  10. Set the user name and password for the database
  11. If you are using a 'sub' database ie your host will only allow you a single MySQL database, set the $table_prefix variable. This allows you to do multiple installs on the same database. For instance assume you have a database named web_data, setting the table_prefix to 'realty' creates the following tables in web_data: realtyhomes, realtytbl_Files, realtyagents, etc.
  12. Unless you want people to just add agents without your control set $require_admin = 'y'
  13. Edit index.php and content/main.php to give the desired content.
  14. Edit includes/thumbnail.php for the image library you have installed on the server. By default the GD libraries are set. If you have either the NetPBM or ImageMagick libraries set the image_style variable to use the other library. (ImageMagick and NetPBM create awesome looking thumbnails compared to GD1)
  15. Run /install/configurator.php to set up the database.
  16. (optional)Rename the folder to freerealty or whatever you want(just make sure the install_path variable is set right in common.php)
  17. You should now be able to upload properties, add agents, etc. by logging into /admin/admin.php
  18. email me at freerealty (at) rwcinc.net to let me know if you found this script useful
Unfortunately, creating the database is beyond the scope of this script.
File Name: FR-2.8.5.php FreeRealty documentation

Welcome to FreeRealty 2.8.5

Beginning with version 2.8.4 additional documentation is being added in an attempt to make use of this project easier. Several different types of installations will be covered in this document. Since this is a fork of Jon Roig's version 2.6 OpenRealty (here) we will first cover installing over the top of OpenRealty 2.6. If you are starting from scratch you can skip to the new install instructions
    Upgrade from OpenRealty 2.6- assuming a clean 2.6 install
  1. Use the upgradasaurus2.7.php file. This file upgrades your database from the 2.6 version setting up new tables to make use of Tom Anderson's feature code. It does this by first inserting the new tables into the current database, modifying each listing to use the new features, then dropping the old tables. The features are editable using /admin/adminfeatures.php. It also sets up the tbl_Files for thumbnails as well as agent_tbl_Files.
  2. To use the new thumbnail features for previewing the homes you will need to convert the existing images in the db by running /upgrades/convert.php This file modifies the database by pulling images for each listing, creating a thumbnail view and inserting that back into the database. /upgrades/convert_agent.php should be run to convert the agent images and add the thumbnails.
  3. Files changed: Nearly every file has had changes, please consult the patch files to determine whether the changes are trivial for your installation.

Clean Install

    By far the 'easiest' install.
  1. Download the latest file eg. FR-2.8.5.zip
  2. Change to the desired directory eg /var/www
  3. Unpack the file #unzip FR-2.8.5.zip will unpack to /var/www/FR-2.8.5/
    • This allows you to play until you 'get it right' as a previous version would be in /var/www/FR-2.8.4
  4. Set up the database. This involves creating the database and setting up a user/password combination.
    • FreeRealty only uses MySQL.
  5. Edit common.php. Hopefully most lines are self explanatory.
    • Set the user name and password for the database
    • If you are using a 'sub' database ie your host will only allow you a single MySQL database, set the $table_prefix variable. This allows you to do multiple installs on the same database. For instance assume you have a database named web_data, setting the table_prefix to 'realty' creates the following tables in web_data: realtyhomes, realtytbl_Files, realtyagents, etc.
    • Unless you want people to just add agents without your control set $require_admin = 'y'
  6. Edit index.php and content/main.php to give the desired content.
  7. Edit includes/thumbnail.php for the image library you have installed on the server. By default the GD libraries are set. If you have either the NetPBM or ImageMagick libraries set the image_style variable to use the other library. (ImageMagick and NetPBM create awesome looking thumbnails compared to GD1)
  8. Run /admin/configurator.php to set up the database.
  9. (optional)Rename the folder to freerealty or whatever you want(just make sure the install_path variable is set right in common.php)
  10. You should now be able to upload properties, add agents, etc. by logging into /admin/admin.php
  11. email me at freerealty (at) rwcinc.net to let me know if you found this script useful
Unfortunately, creating the database is beyond the scope of this script.
File Name: FR-2.8.4.php FreeRealty documentation

Welcome to FreeRealty 2.8.4

Beginning with this version (2.8.4) additional documentation is being added in an attempt to make use of this project easier. Several different types of installations will be covered in this document. Since this is a fork of Jon Roig's version 2.6 OpenRealty (here) we will first cover installing over the top of OpenRealty 2.6. If you are starting from scratch you can skip to the new install instructions
    Upgrade from OpenRealty 2.6- assuming a clean 2.6 install
  1. Use the upgradasaurus2.7.php file. This file upgrades your database from the 2.6 version setting up new tables to make use of Tom Anderson's feature code. It does this by first inserting the new tables into the current database, modifying each listing to use the new features, then dropping the old tables. The features are editable using /admin/adminfeatures.php. It also sets up the tbl_Files for thumbnails as well as agent_tbl_Files.
  2. To use the new thumbnail features for previewing the homes you will need to convert the existing images in the db by running /admin/convert.php This file modifies the database by pulling images for each listing, creating a thumbnail view and inserting that back into the database. /admin/convert_agent.php should be run to convert the agent images and add the thumbnails.
  3. Note that the thumbnail creation should work 'out of the box'
  4. Files changed: Nearly every file has had changes, please consult the patch files and CHANGELOG to determine whether the changes are trivial for your installation.

Clean Install

    By far the 'easiest' install.
  1. Download the latest file eg. FR-2.8.4.zip
  2. Change to the desired directory eg /var/www
  3. Unpack the file #unzip FR-2.8.4.zip will unpack to /var/www/FR-2.8.4/
    • This allows you to play until you 'get it right' as a previous version would be in /var/www/FR-2.8.2 /var/www/FR-2.8.3 ,etc.
  4. Set up the database. This involves creating the database and setting up a user/password combination. How you do that will depend on your host.
    • FreeRealty only uses MySQL.
  5. Edit common.php. Hopefully most lines are self explanatory.
    • Make sure to properly set the $install_path variable. This allows the automatic inclusion of files in /includes
    • Set the user name and password for the database
    • If you are using a 'sub' database ie your host will only allow you a single MySQL database, set the $table_prefix variable. This allows you to do multiple installs on the same database. For instance assume you have a database named web_data, setting the table_prefix to 'realty' creates the following tables in web_data: realtyhomes, realtytbl_Files, realtyagents, etc.
    • Unless you want people to just add agents without your control set $require_admin = 'y'
  6. Edit index.php and content/main.php to give the desired content.
  7. Edit includes/thumbnail.php for the image library you have installed on the server. By default the GD libraries are set. If you have either the NetPBM or ImageMagick libraries set the image_style variable to use the other library. (ImageMagick and NetPBM create awesome looking thumbnails compared to GD1)
  8. Run /admin/configurator.php to set up the database.
  9. (optional)Rename the folder to freerealty or whatever you want(just make sure the install_path variable is set right in common.php)
  10. You should now be able to upload properties, add agents, etc. by logging into /admin/admin.php
  11. email me at freerealty (at) rwcinc.net to let me know if you found this script useful
Unfortunately, creating the database is beyond the scope of this script.
File Name: faq.php FreeRealty FAQ
FAQ- Frequently Asked Questions
  1. How do I set up the Free Realty database?
  2. I get: Fatal error: Call to undefined function: getdb()
  3. Why is the basic FreeRealty install so "ugly" ?
  4. Where can I find better, more complete documentation?