############################################################## 
## MOD Title: Topics Anywhere (topics_anywhere.php)
## MOD Author: DtM < dtm@yucom.be > (Dennis Heeren) http://www.afsvlaanderen.be/topics_anywhere
## MOD Description: Place links to the topics where users have posted recently from any forum on your
##                  phpBB on any page anywhere you want (no support for PHP, SSI, or whatever needed
##                  because it uses JavaScript to show the topic titles) or get those topics as a RSS
##                  feed - this is an extremely customizable addon so it can suit your needs - you even
##                  don't need to modify any files. All you need is phpBB running somewhere...
## MOD Version: 1.11.0
##
## Installation Level: easy
## Installation Time: about 3 Minutes 
## Files To Edit: none (in some cases topics_anywhere.php itself)
## Included Files: topics_anywhere.php
##                 languages/lang_english/lang_topics_anywhere.php
##                 templates/subSilver/topics_anywhere_body.tpl
##                 templates/subSilver/topics_anywhere_result.tpl
##                 templates/subSilver/topics_anywhere_result_rss.tpl
############################################################
## For Security Purposes, Please Check: http://www.phpbb.com/mods/ for the
## latest version of this MOD. Downloading this MOD from other sites could cause malicious code
## to enter into your phpBB Forum. As such, phpBB will not offer support for MOD's not offered
## in our MOD-Database, located at: http://www.phpbb.com/mods/
##############################################################
## Author Notes:
##    In my eyes, this isn't really a MOD, more an ADDON, because there is no
##    need to modify any of phpBB's files.
##
##    For the standard setup there is nothing else to do than placing the files in
##    the appropriate directories. When you've done that, point your browser to
##    topics_anywhere.php and follow the steps...
##
##    By default, only public forums are available to show topics from and are shown in
##    the picklist. If you want to change this so Topics Anywhere shows all forums (this
##    is including hidden and private forums) you have to go to the Config Section of
##    Topics Anywhere. Open the file topics_anywhere.php in your favourite PHP editor
##    (or notepad) and edit the "Config Section". Also, if you want to add your own
##    bullets or date formats, change the permissions of who may generate scripts and
##    RSS feeds or hide specific forums from the picklist then you have to change
##    the configuration of Topic Anywhere. Change whatever is necessary in
##    the "Config Section". Just read the comments in the file to guide you.
##
##    Topics Anywhere should work with phpBB 2.0.0 (not tested) and does work with
##    phpBB 2.0.1 trough phpBB 2.0.6 (all tested). All code generated with earlier
##    versions of Topics Anywhere can still be parsed by newer versions of Topics
##    Anywhere. So if you upgrade, you don't need to get a new piece of code unless
##    you want to use new features. In that case you should browse to topics_anywhere.php
##    again to generate a new code to copy and paste.
##
##    Credits to:
##    - Eric Fichot (or AideInfo) < phpbb@aideinfo.fr.fm >
##      Translated the Topics Anywhere language file into French
##    - Antonio Mercurio (or Mercurio) < antonio.mercurio@progetto.sardegna.it >
##      Translated the Topics Anywhere language file into Italian
##    - Boris Lifanovsky (or kaschei) < boris@lifanovsky.com >
##      Translated the Topics Anywhere language file into Russian
##    - Karsten Pawlik < support@designlab.de >
##      Translated the Topics Anywhere language file into German (not formal)
##    - Daniel Tanasie (or danielt2) < danielt@qct.ro >
##      Translated the Topics Anywhere language file into Romanian
##    - Guillermo Cdiz (or ::wallax::) < wallax@terra.cl >
##      Translated the Topics Anywhere language file into Spanish
##    - Tomasz Fabiszewski (or Bolo) < info@mogilno.com >
##      Translated the Topics Anywhere language file into Polish
##    - Ole (or Maaseiah) < Maaseiah@paradis.tdcadsl.dk >
##      Translated the Topics Anywhere language file into Danish
##    - Sanel Fejzi  < info@Humci.net >
##      Translated the Topics Anywhere language file into Bosnian
##
##    All language files can be downloaded at
##      http://www.afsvlaanderen.be/topics_anywhere/languages.php
##
##    Thanks to:
##    - The people who translated (and are translating) the Topics Anywhere lang file
##    - The phpBB community (especially AbelaJohnB for updating the MOD db)
##    - Everyone who has reported bugs to me so I could fix them
##    - Everyone who has given suggestions for new features
##    - And last but not least thanks to everyone who is using Topics Anywhere
##
##############################################################
## MOD History: 
## 
## v1.0.0 (August 30th, 2002)
##    - Initial Release
## v1.0.1 (August 31st, 2002)
##    - Bugfix: had placed an else clause in the wrong place - now it's ok...
## v1.0.2 (September 9th, 2002)
##    - Bugfix: forgot a slash in the latest post jump icon URL...
## v1.1.0 (September 24th, 2002)
##    - COMPATIBLE WITH phpBB 2.0.0 (not tested), 2.0.1 (tested) AND 2.0.2 (tested)
##    - New feature: possibility to show topics of all forums on your board
##    - New feature: when you show the amount of replies, the 'Replies' word is optional
##    - Changed: allowed input length for class names is now 25 characters
##    - Changed: the way locked/moved/polled stickys/announcements are displayed (now says eg. 'Sticky: (Locked)')
##    - Changed: made the output code more performant by using arrays instead of concatenation
##    - Changed: error reporting routine
##    - Changed: '1 Reply' instead of '1 Replies' (made a singular form)
## v1.1.1 (October 2nd, 2002)
##    - COMPATIBLE WITH phpBB 2.0.0 (not tested), 2.0.1 (tested), 2.0.2 (tested) AND 2.0.3 (tested)
## v1.1.2 (October 2nd, 2002)
##    - Bugfix: problems when there were quotes in topic titles solved
## v1.1.3 (October 3rd, 2002)
##    - Changed: Topics Anywhere is now conforming the HTML 4.01 standard
## v1.1.4 (October 15th, 2002)
##    - Bugfix: when PHP's register_globals is set to Off, Topics Anywhere now handles global variables the correct way
## v1.2.0 (October 22nd, 2002)
##    - New feature: possibility to show topics from multiple forums (not only 'one' or 'all')
##    - New feature: show the name of the forum a topic is in (as a link if you want)
## v1.2.1 (October 27th, 2002)
##    - Bugfix: the last post icon URL now opens in the correct target window
## v1.2.2 (November 15th, 2002)
##    - Bugfix: if there were more announcements than the max amount of topics to show, Topics Anywhere would show
##      all topics on the whole forum. This is fixed, it shows the right number of topics now...
## v1.3.0 (December 16th, 2002)
##    - New feature: only allow Administrators/Moderators/Registered users to setup a Topics Anywhere script
##    - Bugfix: problems when there were quotes in forum names when not as a link solved
##    - Added: French translation of the Topics Anywhere language file (by Eric Fichot)
## v1.4.0 (January 13th, 2003)
##    - New feature: new layout option - possibility to use breaks in output
##    - New feature: possibility to hide certain forums from the 'picklist' on the setup page
##    - New feature: sort on priority of topic (first announcements, then sticky, then normal) or on date
##    - New feature: jump to last post icon as bullet
##    - Changed: now using less variables
##    - Added: Italian translation of the Topics Anywhere language file (by Antonio Mercurio)
## v1.5.0 (January 17th, 2003)
##    - COMPATIBLE WITH phpBB 2.0.0 (not tested), 2.0.1, 2.0.2, 2.0.3 AND 2.0.4 (all tested)
##    - New feature: define max length (in chars) of the topic title
##    - Changed: version number of the previous release to conform the standard used by phpBB (renamed 1.3.1 to 1.4.0)
##    - Changed: install.txt to comply with the new MOD Template
##    - Bugfix: forgot to update one variable to work with PHP's register_globals set to Off, done now
## v1.6.0 (February 10th, 2003)
##    - New feature: option to hide labels (Announcement, Sticky, Poll, ...)
##    - Changed: Topics Anywhere will show a decent message when the source board is disabled instead of nothing
##    - Changed: install.txt to comply with the official MOD Template
##    - Added: Russian translation of the Topics Anywhere language file (by Boris Lifanovsky)
##    - Added: German (not formal) translation of the Topics Anywhere language file (by Karsten Pawlik)
## v1.6.1 (February 11th, 2003)
##    - Bugfix: in the output the CSS & HTML tags were not correctly nested - this is changed
## v1.6.2 (March 17th, 2003)
##    - Changed: CSS class used by the input fields to work with other themes than SubSilver
##    - Changed: install.txt to comply with the new MOD Template
##    - Bugfix: topic titles from hidden forums were shown when all forums are selected - this is corrected
## v1.7.0 (May 18th, 2003)
##    - New feature: possibility to add a blank line between the topic titles
##    - New feature: you can now also select a forum category from which the topic titles should come
##    - Changed: enhanced some parts of the code to be more performant
##    - Bugfix: one variable didn't work with PHP's register_globals set to Off - this is fixed
##    - Added: Romanian translation of the Topics Anywhere language file (by Daniel Tanasie)
##    - Added: Spanish translation of the Topics Anywhere language file (by Guillermo Cdiz)
## v1.7.1 (May 18th, 2003)
##    - Changed: install.txt to comply with the official MOD Template
## v1.7.2 (May 20th, 2003)
##    - Bugfix: fixed an error in the Spanish lang file
## v1.7.3 (June 2nd, 2003)
##    - Bugfix: replaced a forgotten hardcoded '.php' with $phpEx
##    - Added: Polish translation of the Topics Anywhere language file (by Tomek Fabiszewski)
## v1.8.0 (June 20th, 2003)
##    - COMPATIBLE WITH phpBB 2.0.5 and all previous versions (2.0.0 (not tested) and 2.0.1 to 2.0.4 (tested))
##    - New feature: option to show/hide regular topics
##    - New feature: a not-really-foolproof check to see if the famous $full_url at least has been modified
##    - Changed: a little code enhancement so in some cases there will be less work (queries to the DB) to do
##    - Changed: more extensive comments in config section of topics_anywhere.php
##    - Added: Bosnian translation of the Topics Anywhere language file (by Sanel Fejzi)
## v1.9.0
##    - Was never deployed, released 1.10.0 instead
## v1.10.0 (July 31st, 2003)
##    - New feature: RSS v0.91 and RSS v2.0 as new output methods besides the original JavaScript method
##    - New feature: it is now possible to format the output of Topics Anywhere the way you want it to be
##    - New feature: got rid of the $full_url variable which should make Topics Anywhere more easy to use
##    - New feature: in the config section you can enable American style date formats
##    - Changed: moved lots of code around to get a better performing and more streamlined Topics Anywhere
##    - Changed: modified some parameters in the URL of Topics Anywhere to comply to RFC 1738
##    - Changed: when only one forum selected it won't be encoded in the URL
##    - Changed: error reporting routine
##    - Changed: install.txt author notes & install instructions
##    - Changed: all language files are now available from http://www.afsvlaanderen.be/topics_anywhere/languages.php
##    - Bugfix: in some cases there was a space missing in the output, this is fixed
##    - Bugfix: if sort order was 'On date', the 'Show regular topics' option did not work, corrected this
##    - Removed: the check for the $full_url variable became obsolete with this version
##    - Removed: language files from the distribution zip
## v1.10.1 (August 1st, 2003)
##    - Bugfix: using default output with JavaScript delivered incorrect result - fixed this
## v1.10.2 (August 2nd, 2003)
##    - Bugfix: detecting the location of Topics Anywhere went wrong if phpBB was in a subdir - fixed now
## v1.10.3 (August 4th, 2003)
##    - COMPATIBLE WITH phpBB 2.0.6 and all previous versions (2.0.0 (not tested) and 2.0.1 to 2.0.5 (tested))
##    - Changed: Topics Anywhere has a new home at http://www.afsvlaanderen.be/topics_anywhere
## v1.10.4 (August 6th, 2003)
##    - Bugfix: using advanced formatting with Javascript, rep and lpi did not get replaced - solved
## v1.10.5 (August 11th, 2003)
##    - Changed: install.txt to comply with the official MOD Template
##    - Changed: from now on, by default only public forums are shown in the picklist - can be changed in the Config Section
##    - Bugfix: link to forum used the topic id instead of the forum id - corrected this
## v1.10.6 (August 19th, 2003)
##    - Changed: replaced a hardcoded language string to the lang file
##    - Changed: added the phpBB copyright header to the lang files
## v1.11.0 (September 1st, 2003)
##    - New feature: it is possible to let the link from the topic title point to the last post
##    - New feature: hide topics which have not received a reply in or have a startdate older than the specified timespan
##    - Changed: some minor cosmetic enhancements
##    - Bugfix: error reporting wouldn't give the cause of the error when there was only one error
##
##############################################################
## Before Adding This MOD To Your Forum, You Should Back Up All Files Related To This MOD
##############################################################

#
#-----[ COPY ]------------------------------------------
#

copy topics_anywhere.php to topics_anywhere.php

copy language/lang_english/lang_topics_anywhere.php to language/lang_english/lang_topics_anywhere.php

copy templates/subSilver/topics_anywhere_body.tpl to templates/subSilver/topics_anywhere_body.tpl
copy templates/subSilver/topics_anywhere_result.tpl to templates/subSilver/topics_anywhere_result.tpl
copy templates/subSilver/topics_anywhere_result_rss.tpl to templates/subSilver/topics_anywhere_result_rss.tpl

#
#-----[ SAVE/CLOSE ALL FILES ]------------------------------------------
#
# EoM
