View Single Post
Old 01-28-2011, 09:54 PM   #1
kiwidude
calibre/Sigil Developer
kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.kiwidude ought to be getting tired of karma fortunes by now.
 
Posts: 4,230
Karma: 1345754
Join Date: Oct 2010
Location: London, UK
Device: Kindle Paperwhite 3G, iPad 3, iPad Air
[GUI Plugin] User Category

This plugin offers a quick way to add/remove from the selected books to a specified "user category" via the context menu. A user category (defined using the tag browser panel on the left of the Calibre display) can contain lists of any combination of authors, tags, series or publishers. They allows you to categorize your collection at a "higher level" than per book which can sometimes be a limitation of tags/custom columns.

For instance you could create a "Favourite Authors" or "Must Read" user category containing not only selected authors but also specified tags or series names etc. Calibre 0.7.43 now offers a convenient right-click in the tag browser to perform a search displaying all the matches for your user category, making them even more useful.

Calibre itself has a "maintain" dialog accessible from the tag browser panel allowing you to create, rename and delete user categories, as well as add/remove items. However it can be inconvenient to use that dialog to add items with large databases, as it has no search capability. This plugin offers a more convenient right-click alternative allowing you to add/remove from the books you select in the library view.

Main Features of v1.5.3
  • Add or remove selected authors, series, publishers or tags to user categories
  • Move selected value(s) off all other user categories into a different one
  • If multiple items are selected, displays a dialog allowing you to make a sub-selection. Particularly useful when books have multiple tags and you do not want all of them added/removed.
  • Customise the dropdown menu to as minimal or fully featured as you prefer it.
  • Menus enabled/disabled to show whether the selected items are already in the specific user category.
  • Show in tag viewer feature to quickly open and select user category.
  • Maintain your user categories without tag viewer pane visible.
  • No longer requires a restart of Calibre to detect new/removed user categories in the menus.

Special Notes:
  • Requires Calibre 0.8.18 or later

Paypal Donations:
  • If you find this or any of my other plugins useful please feel free to show your appreciation. I have spent many hundreds of unpaid hours in their development and support so any encouragement for me to continue is appreciated!

Installation Steps:
  1. Download the attached zip file and install the plugin/restart Calibre/add to context menu as described in the Introduction to plugins thread.

Version History:
Spoiler:

Version 1.5.3 - 11 Aug 2014
Support for upcoming calibre 2.0

Version 1.5.2 - 06 Jan 2013
Add a Move menu option to support moving books between user categories
Prevent plugin being used in Device View or on Device View context menu

Version 1.5.1 - 29 Aug 2012
Add fixes to handle cases of blank authors and tags

Version 1.5.0 - 11 Sep 2011
Upgrade to support the centralised keyboard shortcut management in Calibre

Version 1.4.2 - 03 Jul 2011
Fix for Calibre code changes made with release 0.8.8 to tag view

Version 1.4.1 - 09 Apr 2011
Support skinning of icons by putting them in a plugin name subfolder of local resources/images

Version 1.4 - 03 Apr 2011
Rewritten for new plugin infrastructure in Calibre 0.7.53

Version 1.3 - 19 Feb 2011
Bug-fix for icon missing and for when user has no user categories created
Bug-fix for ensuring do not cache db reference when switching libraries

Version 1.2 - 29 Jan 2011
Rewritten as 'User Category' plugin
Add configuration dialog
Make menus dynamically populated without requiring Calibre restarts
Popup dialog for choosing from multiple authors/tags
Add menu options to show in tag browser and maintain user categories

Version 1.1 - 10 Dec 2011
Added icons for the submenus

Version 1.0 - 28 Nov 2010
Initial release as separate 'Add To User Category' and 'Remove From User Category' plugins
Attached Thumbnails
Click image for larger version

Name:	Screenshot_1_DefaultMenu.png
Views:	2380
Size:	47.7 KB
ID:	65684   Click image for larger version

Name:	Screenshot_2_Configuration.png
Views:	1624
Size:	25.6 KB
ID:	65685   Click image for larger version

Name:	Screenshot_3_MultiSelect.png
Views:	1877
Size:	20.3 KB
ID:	65686  
Attached Files
File Type: zip User Category-qt5.zip (71.5 KB, 5283 views)

Last edited by kovidgoyal; 08-11-2014 at 10:26 AM. Reason: v1.5.3 Released
kiwidude is offline   Reply With Quote