Difference between revisions of "Persistent Bookmarks"

From TNG_Wiki
Jump to navigation Jump to search
Line 3: Line 3:
 
| mod_summary    = Stores bookmarks in the database making them available on any computer or browser.
 
| mod_summary    = Stores bookmarks in the database making them available on any computer or browser.
 
| mod_validation  = The mod is XHTML compliant.[[Image:Valid-xhtml10.png|44px]]  
 
| mod_validation  = The mod is XHTML compliant.[[Image:Valid-xhtml10.png|44px]]  
|  download_link  = Soon available...
+
|  download_link  = &nbsp;{{Tv90}}[http://ccount.degryse-moeys.net/click.php?id=33 persistent_bookmarks_v9.0.0.0.zip]<hr/>&nbsp;{{Tv80}}[http://ccount.degryse-moeys.net/click.php?id=32 persistent_bookmarks_v8.1.3.zip]
 
| mod_author      = Bart 'Roebie' Degryse
 
| mod_author      = Bart 'Roebie' Degryse
 
| mod_url        = [[Persistent Bookmarks]]
 
| mod_url        = [[Persistent Bookmarks]]

Revision as of 06:10, 28 April 2012

Persistent Bookmarks
Summary Stores bookmarks in the database making them available on any computer or browser.
Validation The mod is XHTML compliant.Valid-xhtml10.png
Mod Updated {{{mod_last_update}}}
Download link  
TNG 9.0
persistent_bookmarks_v9.0.0.0.zip
 
TNG 8.0
persistent_bookmarks_v8.1.3.zip
Download stats {{{download_stats}}}
Author(s) Bart 'Roebie' Degryse
Homepage Persistent Bookmarks
Mod Support TNG forum
Contact Developer
Latest Mod 9.0.0.0 for TNG v9
Min TNG V 8.1.3
Max TNG V 9.0.2
Files modified
admin_backup.php
admin_genconfig.php
admin_maketable.php (new file)
admin_optimize.php
admin_restore.php
admin_utilities.php
ajx_addbookmark.php
ajx_delete.php
ajx_deletebookmark.php
bookmarks.php
cust_text.php
customconfig.php
tabledefs.php
Related Mods
Notes


Purpose of the mod

This mod will store the bookmarks in a database making them available on any computer or browser. As storing these bookmarks happens per user this mod will only work for logged in users. The current way of storing bookmarks in cookies remains untouched and fully functional.


Developer

This mod was developed by Bart 'Roebie' Degryse


Requirements

  • A working TNG installation.
  • A backup of all affected files (see the list in the summary in the upper right corner of the page)
  • An installed current version of the Mod Manager (is already included in TNG v9)


Installation

  1. Download the appropriate zip file as shown in the summary in the upper right corner of the page. NOTE that I host these zip files on my own server. That way I can count the number of downloads for each mod I made and estimate the relevance of such mod.
  2. Extract the config file from the downloaded zip file into the mods folder
  3. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the mod.
  4. Go to Admin >> Setup >> Configuration >> General Settings >> Table Names. Name the new bookmarks table to your liking (default is tng_bookmarks) and press the Create... button. You can rename the table at any time by changing it's name and pressing the Create... button again. You won't loose any existing data!


Other Languages

Those who use other languages in addition to English can find appropriate mods to add Dutch, French or Spanish custom text additions in the summary in the upper right corner of this page. Follow the same procedure as explained above to install them.

If you want to add another language please send me the translation (either the texts or as a full language mod) and your name (so I can give you credit) by sending me a personal message from the TNG forum.


Feature List

  • Each visitor has his bookmarks available on any browser or computer. He only has to log in to see them.
  • No limit to the number of bookmarks a visitor can store.
  • The current cookie bookmark system remains untouched and fully functional for visitors that don't or can't log in.
  • The bookmark table can be optimized, backed up or restored just like any other table.
  • The bookmark table's structure will be backup up together with all other tables. Note that restoring such backup after explicitely deleting the table and uninstalling the mod will restore the bookmarks table. So you should probably make a new table structure backup after uninstalling the mod.
  • Deleting a user will also delete any bookmarks (s)he might have stored.


Visualization of this mod

The following images show the visual effects of installing the mod.

Setup >> Configuration >> General Settings

Under the 'Table Names' header on the General Settings page you'll find an extra textbox and button where you can name and create the table for storing the bookmarks.

With the mod installed
Utilities >> Back up, Restore & Optimize Table Data

The mod adds the bookmarks table to the list of tables you can optimize, backup or restore.

With the mod installed
Bookmarks

With the mod installed the bookmarks page first shows those bookmarks that are stored in the database (if any). Unter that you'll still find the bookmarks stored in the cookies (if any).

These two groups are totally independent from each other. Thus you can delete from one group without affecting the other group

When you're not logged in you'll only see the cookie bookmarks.

Bookmarks page with or without the mod


Uninstalling the mod

If you want to fully uninstall this mod remember to delete the bookmarks table after uninstalling the mod. At this moment the mod has no option to do that for you. So you will have to do it directly on the database server by using phpMyAdmin (available on most hosted servers) or alike.


In the event of a problem

  • Try using the Mod Manager Remove capability
  • Contact me through the TNG forum.
  • Contact me by email. My email address is in the description column of this mod on the Mod Manager page
  • Copy the backup of the affected files back to your TNG directory


Revision History

Version Date Contents
v9.0.0.0 28 April 2012 Initial config file release
v8.1.3 28 April 2012 Initial config file release
Starting with TNG v9.0.0.0 the logfile mentions the username of deleted users instead of their id. This mod introduces this feature also in TNG v8.1.3 since it needs to fetch that username anyway for its own use two (!) lines earlier.