Htaccess File Editor

[ebmarques]

HTACCESS FILE EDITOR ADD-ON FOR OPEN-REALTY
@version 1.0.0 - April,22/2007
@author Eduardo Marques <ebmarques at gmail dot com>

Notes:
- Tested with Open-Realty v.2.4.0 installed at Transparent Technologies Servers
- This add-on was planned to be a commercial add-on but with Ryan Bonham's help to get this add-on working, wasn't fair to make some money - wouldn't you do the same? Thank you very much Ryan Bonham for the help!

--------------------------------------------------------------------------------

This add-on is a HTACCESS FILE EDITOR: create, edit, save, rename and CHMOD (all actions with a JavaScript alert box asking for confirmation).
This add-on handles ONLY 2 files: ".htaccess-or" and ".htaccess" If you have none of these files the add-on will create a ".htaccess-or" file with the Open-Realty default content at the root of your Open-Realty site.
This add-on needs a valid FTP conection - otherwise no actions are going to be available. This add-on DOES NOT delete files!

REQUIREMENTS:
-------------
- FTP module installed at the server
- valid FTP account to handle files

IMPORTANT:
----------
Thre are NO guarantees this add-on will work at a server other than Transparent Technologies Servers. So if you have problems you shall contact your Hosting Company for support. Please backup your actual ".htaccess" file before installing this add-on!

ATTENTION:
----------
Only ADMIN will be able use this addon. There is nothing set to interact with the frontend of your site. All actions are performed at backend and needs ADMIN logged.

INSTALLATION:
-------------
Decompress the file htaccess_addon.zip inside your "addons" folder. This zip file will create a directory named "htaccess" with several files. Login at your Open-Realty Control Panel as ADMIN and you will be able to start using the add-on. This add-on DOES NOT modify your database. The "_readme.txt" file inside the zip file have all instructions.

MUST DO AFTER INSTALLATION - OTHERWISE THE ADD-ON WILL BE DISABLED:
-------------------------------------------------------------------
This add-on needs the user name, password and paths to login to the FTP Server of your site so this data need to be inserted to use this add-on - otherwise no actions are going to be available and the add-on will be disabled. You will need to edit the file "ftp_details.php" - look the source code of this file and folow the instructions at this file. With no FTP module installed at the server, the add-on will be also disabled.

HOW TO USE:
-----------
This add-on will perform the following actions:
- detect the existence of two files: ".htaccess-or" and ".htaccess"
- if no file found, creates ".htaccess-or" file with the default content
- restore your actual file with the default content
- rename file from ".htaccess-or" to ".htaccess"
- rename file from ".htaccess" to ".htaccess-or"
- edit your actual file and save it

All actions are going to ask for confirmation with a JavaScript alert box. This add-on will perform all the above actions changing the permissions (CHMOD) of your file to "0777" and will change to "0644" at the end of each action (you can change these values at "ftp_details.php" file).

TRANSLATIONS:
-------------
All texts uses lang variables present at an add-on "lang.inc.php" file. Edit this file to fit your needs.

UNINSTALL:
----------
This add-on DOES NOT modify your DB so you just need to delete the directory "htaccess" (and all files inside it) created at your "addons" folder.

UPDATES:
--------
I am NOT planning to release updates of this add-on (besides bug fixes if the case) so feel free to modify the code to have an add-on even better.
For example:
- the "rename" functions could be just one function...
- the FTP details could be stored at the DB...
- and (?)...

That's all. Have fun!
Eduardo Marques <ebmarques at gmail dot com>