Roaming Nomad Documentation --------------------------- http://roaming-nomad.sf.net Maintainer/Team/Tech Support: ----------------------------- Petr Prokop: zwei2stein@gmail.com Preface: -------- Roaming Nomad is tool to help notorious surfers organize their discoveries and navigate web with greater ease. Its in-fact bookmark system with some unique fucntions and easy web acces so that you can add links or viev shedule from anywhere. Current key features are: * Directory-like categorizing, resembling file navigators like norton comander * Sheduling of revisit, that should help with "i migth want to check this out in one year, but i dont want memorize it right now." also it makes easier to navigate many frequently updatet sites making sure you dont miss one of them * Full-text searching in links. This turns Nomad to pseudo search engine - true catalog. * Slick GUI * Secure by default Instalation: ------------ REQUIRED SOFTWARE/HW: * webserver able to run PHP. i.e. something like Apache 1.+ * PHP 4.1.+ (newer, better) * MYSQL 3.+ (newer, better) note: this is aplication designed to be used as extranet aplication, instaling it on your personal computer is not recomented. you want this because access from everywhere, dont you? if you dont have/(wish to pay) money for dedicated webserver, try some freeweb hosts, i.e. www.webzdarma.cz offers mysql hosting with php. 1) unpack to desired directory in webserver document directory 2) create databaze in mysql ( sql/database.sql ) 3) edit config.php incule your login information to database and database name, set other params. 4) in database, add your user. 5) in webbrowser, locate index.php - it should be working right now. 6) feel free to delete all demo sections and links and to start collecting links right away. Known Bugs: ----------- * No key bug right now Updating old versions: ---------------------- 0.2a -> 0.3a 1) run update-0_2a-to-0_3a.sql on your db 2) overwrite all source files 0.3a -> 0.3b None needed 0.3b -> 0.4a 1) execute update-0_3b-to-0_4a.sql 2) overwrite sources NOTE: since this changes how new links are handeld, you should edit and categorize all new links you have displayed on homepage ... 0.4a -> 0.42b 1) execute update-0_4a-to-0_42b.sql 2) overwrite sources further updates: err... thats what those update sql thigies in sql dir are for :] changelog: ---------- * - infromation + - new feature ! - change of feature x - bugfix 0.5b x Fixed security bug: anonymous users are no-more able to edit categories or resehedule links by visiting it. ! Also, all pages are protected from url-massage (hopefully ...) ! Category trees are now ordered, hope this helps usability. x Aditional design cleanups + Full XML export + Private categories implemented. + Private links implemented. prerelease 6.5 (0.4.2b) 25.03.2004 ! Rendering of links improved + New info box: history of visited links + Rendering of index.php tables moved to function to better organize code. ! Editing links dialog now contains clicable link. + Much more comfortable login-logout interface (accesible from every page, remembers ones location ...). * Even better gui :) x Quick-jump now cidentifies category you are in. ! When to visit or to edit is empty, message is displayed + Ton of new shedule commands ! Search results are now ordered prerelease 6 (0.4.1a) 16.03.2004 x Corrected saving link info when new shedule was set, but not used for first time ! Help has now link to readme.txt (this file) ! Keywords and description of page are now more customized and allow better indexing (NOTE: currently, crawling through this page WILL destroy calagoue as edit and delete commands are hyperlinks without user checking !!!) ! RSS has better intengraton ! Small design touch-up. hope it helps a bit. + Rendering links is now more maintainable x Redering "never" wisiting in cion is fixed + callto: protocol supported + Search results now include category of found links ! We are finally using logged user for something (disabled editing/deleting links for anonymous) :) prerelease 5 (0.4a) 13.03.2004 + Help page with meaning of used symbols + Added symbols of shedule to link display * Created nice headers for all files x Root of category tree is displayed in frontpage x Tootip in trees are now correct + Basic search implemented + RSS export ! Editing link also displays info ! Default names for linkd are now trimmed + Logging in for users - it does not do anzthing else than log in and display whos online though ! Going up from root moves user to index ! New links have different handler prerelease 4 (0.3b) 22.01.2004 + selection of categories in edit link and edit category are in trees for easier navigation + links to categories are now under folder images, link images link to url without visitcheck + tree of all folders on homegae + all pages got quicl link dropdown to all categories. x fixed save category + security is increased - all incomig data is filtered fo xxs attacks. * Title of page is more informative * Version diplay prerelease 3 (0.3a) 16.01.2004 x - added link now redirects back to category its was created in and not to root category + - homepage has more info x - to-edit links are no longer included in to-visit + - index.html has code and redirects to index.php, thus instalation of apache which dont support index.php as default page have workaround + - new protocols recognized: gnunet, news (usenet) and gopher + - favicon.ico prerelease 2 (0.2a) 31.12.2004 * More usable, security is current problem (no loging in and user verification ... anyone can delete whole database right now) * Minor changes in db ! links are added without bugging setting ! the same for categories + sheduled revisiting + counting visit statistics + more protocol icons (https, gopher) ! some gui changes prerelease (0.1a) 27.12.2004 * All in all, this is usable, but not recomented to run. * Databaze desing is not solid, new colls and tables will arrive to acomodate more complex functions + Section handling (creating, assigning to parent and editing info, deleting) + Link handling (creating, assigning to parent and editing info, deleting) + Link automaticaly gains icon of used protocol (http://, ftp:// ...)