Introduction:
EasyMOD is an automatic MOD installer. It does in seconds what used to be the laborious and time consuming task of manually editing files. EM will install EasyMOD Compliant (EMC) MODs and also *try* to install all other MODs as well. For most users, MOD installs should be completely automated. There are break points so you can check what EM proposes to do before it makes any permanant changes.
Author's Notes:
EM is not yet feature complete. Most noteably it is missing SQL processing and an uninstaller. Since EM is not feature complete it is considered alpha software. EM has
over 7500 lines of PHP code and this does not even include the 1000+ lines already written to handle SQL processing or the 8 template files. However, this is the 8th public release and by now the features EM does have are release quality. So feel free to install but remember it is not yet as good as its going to get
Now that EM has reached a certain level of maturity, a refining process will take place. I will document how best to write MODs for EM (EasyMOD Compliant). A key to success will be getting MOD Authors to write their MODs so they don't clash with other MOD installations. My goal is to present a clear, reasonable, and unintrusive as possible method.
Lastly, thank you
Daz for providing the EM graphics, thanks to the translators listed below, and special thanks to my 1337 Pre-Release Tester Team:
Ptirhiik - RPGnet-fr, wGEric, morpheus2matrix, GPHemsley, LifeIsPain, and
DanielT
Installation:
Download EM:
--LINK REMOVED BY NUTTZY--
Look here:
http://area51.phpbb.com/phpBB22/viewforum.php?f=15
New installs:
1) Extract in your admin directory. The proper directory heirachy should be admin/mods/easymod
(note that "easymod" is now lowercase)
2) From a web browser, open http: //{YOUR BOARD ADDRESS}/admin/mods/easymod/easymod_install.php The install will guide you through everything and no modifications occur before warning you.
3) If you are using FTP access make sure you, as the owner, has write permission on ALL your phpBB files (744)
4) Once installed, you may wish to install the
Country Flags MOD which is the only "official" EMC MOD.
Upgrading:
It is advised that you remove any previous admin/mods/EasyMOD directories. Once they are out of the way, just follow the install instructions above. EM will figure everything else out
Features:
- Choose from some fully automated installation methods and some manual methods as well. You decide what's best for you!
- the modifed files generated can be:
- written directly to server (requires write access in the "mods" dir)
- written to a buffer and FTP'd into place (requires FTP access)
- downloaded to your local machine
- written on screen in a seperate browser window (requires you to be sadistic
)
- If you are satisifed with the modifications, the files can then be moved into place
- by the copy command (fully automated: requires write access to ALL dirs from phpBB root downward)
- FTP'd into place (fully automated: requires FTP access)
- execute a script (fully automated: requires permission to run scripts)
- manually loaded (requires your time
)
- robust installer (needs some work though
)
- the program is ready to accept translations for multiple languages
- support for ALL MOD Template functions (COPY command needs some work)
- install MODs to all installed themes
- install MODs to all installed languages
- automatically backups up files before modifying (you should still make your own backups though!)
- continued processing if non-English or non-subSilver file fails - you decide if you want to continue or not
- password protected - even admins cannot access EM unless the board owner gives them the password
- object oriented programming - classes could be used in other programs
- install EMC MODs
- *try* to install non-EMC MODs
- settings ACP
- installed MODs history ACP
- view MOD script from the install screen (click link)
- security-conscious every step of the way
- MOD script line numbers appear where ever they will be helpful
- convinient install debugger
- I'm sure there are more but I don't feel like thinking about it anymore

To Do List:
Things to be added/fixed in 0.0.11:- COPY command needs to handle *.* and entire directories
- preview mode to see what changes EM proposes to make
- multi-lingual support (with author notes
)
- better debugging for people messing up the FTP path
- reinstalling EM after board upgrade - yashin19
- any bugs that come up in 0.0.10
- compensate for hard coded image paths in tpl - -=ET=-
- allow for the entry of alternate FTP host names
- throw an error if multiple target lines appear in IN-LINE commands - Jeep
- limit what commands will be accepted
Things to be added/fixed in Beta 1:
- SQL processing
- INCREMENT command
- auto restore backups option
- uninstaller option
- some way of cleaning up disk space
- comphrensive method for dealing with lang packs
Translations:
EM is going international
Translations of lang_easymod.php are needed!!! Several translations have already been completed although EM will not really utilize them until version 0.0.11. Below are the languages submitted and their current status:
- Language - Author - EM version
- Danish - AlleyKat - 0.0.9c
- French - Jaeboy - 0.0.9
- German - Balint - 0.0.9c
- Norwegian - Espenhh - 0.0.9c
- Portuguese - JuniorZ - 0.0.9 (file not available)
- Swedish - Kail - 0.0.8
Language version changes
The language change log can be found
here
Bug Tracker:
Bug // Reporter // status
---no 0.0.10a bugs submitted yet --
Changes from 0.0.9c to 0.0.10a:
Changes from 0.0.10 to 0.0.10a:
fixed COPY command to allow "copy dir/file to dir/"
fixed download option
fixed on screen option
added a debug mode for FTP with the installer
confirmed the FIND command already works perfectly (so don't bug me CE

)
Changes from 0.0.9c to 0.0.10:
fix bug with mkdir return
missing buffer+ftp option on settings ACP
COPY command working except for *.*
make FTP the default methods
code paths correctly!!
../ in path a problem for some FTP servers -
Aexoden
settings ACP should autocomplete with old settings
run FTP access test in debugger for move method
fix pass by ref warnings -
GPHemsley +
Ptirhiik
correctly parse MOD header to allow for EM to detect more MODs
display info on how to install other MODs
make sure english and subsilver are present before installing
lowcase EasyMOD dir to be easymod

temporary quick fix to determine if file is ASCII or binary
fixed a duplicate lang file entry
make COPY accept unlimited tabs and spaces
changed mod_file param in EM table to be 255 chars (was 50)
fixed finding a bug with multi-line finds -
GPHemsley
streamlined the function that performs FINDs
Previous version changes
The complete change log can be found
here
-Nuttzy
