==============Agent-See ver 0.975b  From Bright Banana===================

Copyright Bright Banana 2002-2004
info@brightbanana.co.uk

Need *quality* php/mysql UNIX hosting???
http://www.brightbanana.co.uk/products/hosting.php3

This software is OPEN SOURCE and released under GPL

****************************************************************************

  This program is free software; you can redistribute it and/or
  modify it under the terms of the GNU General Public License
  as published by the Free Software Foundation; either version 2
  of the License, or (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License <http://www.gnu.org/copyleft/gpl.html>
  for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

*********************************************************************************
*                              Agent-See contains code from:                    *
*                                                                               *
*                 openreality: http://jonroig.com/freecode/openrealty/          *
*                                                                               *
*                                                                               *
*                           the changes from that are listed here              *
*                                                                               *
*********************************************************************************

Open reality is an american based real estate web app. We needed a similar solution 
but in *english* so we decided to use open reality as a *base* the changes are broadly 
local based, state == county etc and then I started thinking "oh that feature would be 
nice and I could do this" so I started to "bolt" extra bits on!


*********************************************************************
*                                                                   *
*                  Version 0.975B APRIL 2004                        *
*                                                                   *
*********************************************************************

*Now works with REGISTER_GLOBALS = OFF

*Improved Windows Support - tested on Win2003 server with php/mysql

*New admin login/works under win too!

*More languages

*Slowly moving towards functions/oop

*REMOVED WEBCAL


*********************************************************************
*                                                                   *
*                  Version 0.950b March 2003                        *
*                                                                   *
*********************************************************************

!!BIG CHANGE!!!!BIG CHANGE!!!!BIG CHANGE!!!!BIG CHANGE!!!!BIG CHANGE!!

=======================IMAGES=================================

Images (homes and agents) are now stored in:

images/homes
images/agents

respectively. This was to free up the database of binary images files.
You will need to chmod these directories on your server. 

Also if set to Yes (in settings.php) when you upload a (HOME ONLY) image
GD resizes and changes the quality setting on JPG images then creates a
thumbnail (saved as tn_image.jpg) in the images/homes directory. This should
speed things up When you view the "show all properties" pages.


===================Yahoo! Maps================================

Fixed this little issue! Now when you create a property listing you MUST
enter country and postcode - we can work out the correct country to pass 
these to Yahoo! Maps  

See this file:

includes/maps.php

for country definitions which you can add to by finding out the appropriate
url for Yahoo! Maps


====================LEFT NAV==================================

You can now disable the left navigation/featured property area by selecting
N in settings.php


================REQUEST-A-VIEWING=============================

Added request a viewing feature.


===================DATE ADDED=================================

Added a "date-added" which puts a date which adds a date to all listings 


*********************************************************************
*                                                                   *
*                  Version 0.903b January 2003                      *
*                                                                   *
*********************************************************************

=================MULTIPLE CURRENCY SUPPORT====================

I have added multi currency support by allowing for different currency symbols. Just Put
your countries currency symbol (  $) in settings and VIOLA!:)




================MULTI LANGUAGE SUPPORT========================

There are three files that control some lanuage settings.

includes/language/enUK.php
This is the main language def file at present to change copy and rename 



*********************************************************************
*                                                                   *
*                  Version 0.901b 05 DECEMBER 2002                  *
*                                                                   *
*********************************************************************


===============WEB CALENDAR===================================

This is a powerful web app that allows you to keep an online appointments diary and much more!

I have integrated web calendar with Agent-See so that when the ADMIN creates a new AGENT account 
one is also generated for web calendar. Also if the agent modifies his account the changes are 
reflected in web calendar.

!!!INSTALL!!!
CHANGE THE DB info in CALENDAR/INCLUDES/CONFIG.PHP TO THE *SAME* AS AGENT-SEE
THATS IT! AGENT-SEE WILL THEN WRITE NEW USERS INTO webcal_users 

More info about web cal can be found in calendar/docs 

==================DOCUMENTATION==============================

In the process of improving the documentation!



*********************************************************************
*                                                                   *
*                     Version 0.9b 15-11-2002                       *
*                                                                   *
*********************************************************************


It's been a long time since 862 was released! Am working on Agent See again! 


===============SILLY MISHTAKE #34=============================


When adding a new *agent* script was barfing due to a silly typo in addagent.php
WAS agentelmail
NOW agentemail 

D'oh!


==================IMPROVED FORMATING========================


Made the logic spit out listings with nice alternate colour tables. Just makes things
look a bit better.

=========================ADMIN===============================

Admin area now pw protected with PHP AUTH rather than .htaccess files - include authen.php
does the work and uses the user/pw combi in common.php  


=========================ADD-AGENT===========================

Now emails the address specified when signing-up, with login details.

====================SETTINGS.PHP=============================

Rather than store all the settings in a plaintext file I thought it would be fun to make
things more complecated and store them in a table (settings) in the DB! Seriously this has the advantage
that the admin can change all the settings from the browser whether this *is* an advantge 
is for you to decide :)


====================MORE SECURE Pt2==========================

Ok as we now crypt() the passwords I have made a new bit that generates a new randomish pw
crypts it and writes it to the db and emails the agent the clear pw so they can get in 


====================MORE SECURE==============================

Agent passwords were stored in the db in cleartext, this is a security risk! So I have
crypted them. Because crypt is one way there is no way of emailing them out to users, 
should they forget them, so have removed that option - am working on a generate and 
email new password option



*********************************************************************
*                                                                   *
*                     Version 0.882 08-08-2002                      *
*                                                                   *
*********************************************************************

================CHANGES IN 0.882============================


===================BROWSE.PHP===============================

Improved the browse.php page. Removed the extra options like alarm,transport etc...
Have added a new page:
browse-adv.php 
so that we can do an advanced search if ppl want. Just dont want to overwelm ppl with
loads of options.


=======================P3P==================================


Have built a demo p3p doc! You WILL need to edit this for your needs
You can do this by hand (it's a XML doc) or use an p3p editor (like i did).

W3C/
p3p.xml -------- THE XML REF FILE
privacy.p3p ---- THE PRIVACY FILE 
privacy.txt ---- THE COMPACT POLICY

there is also a 'REF' in templates/user_top.php
<link rel="P3Pv1" href="w3c/p3p.xml">

If you move anything make sure this still points to the xml file!



================LOGOUT.PHP===================================


logout.php modified to log out user and load the hompage.


===============IMAGES ON/OFF================================

Have added the ability to turn images off (the ones in the show all listings),
because these can be 40K each and we can have many of them; The defualt page
can be configed to nopropview.php or propview.php depending on what you need I would
say serve up the page with no prop images and allow end users to follow the link to 
turn them on, if they so desire.

NEWPAGE ----- nopropview.php



*********************************************************************
*                                                                   *
*                     Version 0.862 08-04-2002                      *
*                                                                   *
*********************************************************************
================CHANGES IN 0.862============================


A lot can happen in two months....

...Mostly, bills, happen to me:)

==================THE GIMP==================================

We reccomend the use of the GIMP (GnuImageManipulationProgram) for optimising images. It is 
Open source and free. There is a brief guide in the help area for the GIMP. Although we don't 
Package the GIMP with Agent See (it's too big, if you only need Agent See) you can get it
from the Bright Banana Website, if you need it.

==================PRIVACY.PHP===============================

You will find an EXAMPLE privacy policy in the includes directory, you WILL need to modify 
this for your own use!


==================MORE HELP=================================


Have added more help for users and customers alike


=================MORE VALIDATION============================


Yay more client side form validation!!! Stops (L)users from submiting crap, well, tries to


===================META.INC=================================


Theres now a meta include. You will need to change this to suit your site.
Standard META tag rules apply!

You will find it in  includes/meta.inc


===================NEW LOOK==================================


Change the look a bit, to match the BB site.


===================COMMENTS.PHP==============================


This page in assoc with formmail.php parses user feedback and sends 
it to the address specked in common.php so make sure you fill it in:)
$youremail = "you@yourdomain.com";


====================POP UP MENUS============================

Added some pop up menu type things for navigation


====================NEW PAGES===============================

contact.php -------PUT YOUR CONTACT DETAILS HERE
Buy.php     -------ADVICE ON BUYING A HOUSE
rent.php    -------ADVICE ON BUYING A HOUSE
about.php   -------ABOUT THE SITE
privacy.php -------YOUR PRIVACY POLICY
problems.php-------HELP IF USERS HAVE *ISSUES*

These are there to make it easier for you to include these pages whithin Agent See  

====================USER_TOP================================

Changed this file from a plain old html to a php file so we can include and parse stuff on it.
The other headers/footers remain html cos they are only needed for agents and admin - for the moment.


====================TITLE=====================================

I have added the title attribute to images so that when you rollover it says;
"click here to discover more about *the property title* "

====================PROPER HTML===========================

in the process of escaping " in php; for example

alt=10 
alt=\"10\"

So we get *proper* html outputted to the browser



*********************************************************************
*                                                                   *
*                     Version 0.842 08-04-2002                      *
*                                                                   *
*********************************************************************

====================LOCALS===========================

We have changed values such as ZIP and STATE into the English counterparts.


====================RENTMORT==========================

This value has been added to the database so that we could have a field saying rentperweek or Freehold etc...

There is also a $rentmort variable:) Well Duh!

====================DESIGN============================

We have (are still:) removed the hard coded <font> info, using a stylesheet in their place!

Have added some cute:) little recycle bin icons in the agentadmin bit were the delete listing link is, which improves the stability and makes it run faster on our server - Ok I'm just being silly:)


=====================PROPERTY TYPE=====================


We have changed the property types into ENGLISH types: Semi, flat terraced etc...


=====================COUNTIES==========================

We have added ENGLISH counties, which is nice:)



=====================IMAGES============================


Have allowed ONLY jpeg to be uploaded! This stops ppl uploading dodgey stuff:) - Uploads have now been changed so that you can only upload JPEG files This uses a bit of code (clearly marked) to veryfy  (using file_type) that the file is a REAL JPEG. 

KNOWN ISSUES:

THIS WORKS FINE IN:
IE 5 5.5 
NETSCAPE 4.73 
NETSCAPE 6.1 6.2 
MOZILLA 1

BUT NOT OPERA 6! it looks like its due to the fact Opera sends the file_type info with some extra stuff on it:( I'm working on a fix for this as we speak (or type) Cos I really like OPERA. 



=====================ERRORS!=================================

This thing worked fine on my local Windoze server (apache mysql php) but failed on a *proper* UNIX server! The proplem was caused by a banjoed table name in the code:

agents_Files

is not the same as...

agents_files

All fixed now:)

===========================EMAIL================================

Fixed the hostname thing in friendmail.php just a typo in the address variable

Same *issue* in emailpass.php

===========================Security==============================

Ok the common.php contains the db user and pass this is not too good:) so have moved it to a directory called "includes"  which can be moved out of your Web path OR just protected with the INCLUDED .htaccess file.

There is a README in the INCLUDES directory with more info

.htaccess and .htpassword
You need to ENSURE that you GENERATE A PASWORD for the .htpassword file you can do that here:
http://www.inch.com/info/tech/HOWTOS/htaccess/htpasswd.html

The Place the two files in the admin directory and ENSURE your ABSOLUTE PATH in .htaccess points to it eg:

AuthUserFile /home/site/public_html/agent-see/admin/.htpassword 

Then you will need to enter the user and password you generated with the above tool.

This is not a *bullet-proof" security system but it does afford a measure of protection from the *script kiddies*:)


=============================ACCOUNT EDIT=================================

Have fixed the *issue* that stoped the user from changing some of their account details


=========================CLIENT SIDE VALIDATION==========================

I have added some JavaScript to stop (L)users from adding bad values to the database the Functions are in the header files

Also added a "Are you sure" modal Popup for all the delete actions! This gives you a chance should you not want to delete a listing/agent.


=============================MAILING LIST=============================

OK I haved added some mailing list functionality to this version using easyletter (cheers guys) This is still in early BETA (like the rest of this:) so make sure you get the latest version! But it does work and you need to log into the /admin area to use it. then just hit SEND and it will mail ALL your subscribers with Links back to ALL your properties In a plain text email.

Like I say its nothing fancy at the moment but it works and its FREE:)



============================Suggestions==================================

Ideas, comments, money:) can be sent to me at:

stuart@brightbanana.co.uk

If you want to support this and other BB Open Source projects:

Need *quality* php/mysql UNIX hosting???
http://www.brightbanana.co.uk/products/hosting.php3


=======================WANT NEW FEATURES???==============================
Why not join the Agent-See Development Team! Yes! If you have skills which you think Agent-See could benefit from, then join the team and put something back into Agent-See.

Email me for more info::
stuart@brightbanana.co.uk