ImageDetailed procedure to Upgrade to Bookmarks  (v2.6 and above)

Preparation:
Read (again) the Readme file in the ZIP...


Here is a more detailed procedure, and I do assume that you have understood the main stream of the upgrade procedure...

Step 1 : Backup
OK, now looking for SQL backup instructions...
I assume that you are using phpMyAdmin...

- So first start the phpMyAdmin console...
- Select the right Database
- Click on "Export" tab
- In the left box "tables list", select (ctrl+click) the "jos_bookmarks" tables (6 tables).
- in "SQL Options" right part :
.... "Structure" section, select :
[x] Add DROP TABLE
[x] Add IF NOT EXISTS
.... "Data" section, select :
[x] Complete inserts

- Then enable [x] Save File (leave "none" for clear text..).
- Finally click the "GO" button to start the backup query...

Now you should have a backup of your tables on your local disk...
Just verify it, and retry backup process if you think it is unsuccessful...

Step 2 : Upgrade files

Method 1 :
Now, as the backup is OK, you can :
- Uninstall the Component (that will remove the tables),
- Install the new version
- Restore the saved tables.

How To restore the saved tables :

Open the SQL pane, open the saved SQL file, then click the "GO" button to execute the queries...

Method 2 :
You can also use a FTP client, and simply replace all files from the ZIP on your website.
Important : place each file in its correct location !

Step 3 : Table Structure Upgrade
And now, the last and important point : Upgrade the Tables structure...
=> in the Back-end > Component : "Bookmarks" > Operation Center (OPC) > Tab : "Tables" > Action : "Check DB integrity". This action will perform the needed upgrade of your SQL tables and some files verifications...

Step 4 : You're done...
If you performed all the steps correctly, you should have the Component with the latest table structure and all your data...
Check the Control Panel for new parameters...


Addendum : Manually Uninstall Component:

If you have issues while installing the Component and the system is telling that there is already a component with the same name, you certainly need a manual cleanup of the old Component :

Normally to uninstall a Component, you must remove it from Joomla/Mambo, with the Component Installer...
It will remove files and SQL tables properly...
But in some cases you will need to manually remove the old Component, so first you must remove the following folders (folders, sub-folders and all files) :
- "/administrator/components/com_bookmarks/"
- "/components/com_bookmarks/"
Then in MySQL remove the tables starting with "jos_bookmarks" (6 tables).
Note : the Bookmarks data will be erased, ensure you have a backup before doing this action...
 
And finally you have to cleanup the "jos_components" table, by removing records where the field "option" contains "com_bookmarks".
=> Execute the following SQL query to find the records to delete : 
SELECT * FROM `jos_components`
WHERE `option` = "com_bookmarks"
ORDER BY `admin_menu_link` ASC
Then remove the records founds (should find ~8 rows)...
And finally you should be able to install latest version...

Happy upgrade !

DJesus