1) Download the samplebundle
If you have Xcode installed you can download the xcode project (which contains the css and files required by hunter suite);
if you don’t have xcode you can download the bundle.
The tutorial explain how to modify the bundle, but you can easily adapt the instruction if you want to use the xcode project.
2) Showing Content of the bundle
Right click on the bundle and chose "Show Package Contents"
3) The Info.plist file
In the "Contents" Directory open the "Info.plist" (you can open it with text edit), you need to edit:
- Creator you should replace "Your Nick" with your name, or nick name. This will appear in the plug-in manager window as the creator of plug-in.
- HSPluginName you should replace "Sample View" with the name of your plug-in.
- You can also edit the CFBundleVersion the version is used by the hunter suite to display update of plug-ins to users.
4) the Main.css
Now open the "Resources" Directory
You will see 3 files. The "English.lproj" it’s useless ignore it.
Main.css is the css file you need to edit to chage the view.
The classes of the css file.
- body it’s the whole view page
- div.item the division that contains the whole item (title and all the details) when a single item is selected
- div.dvd-title it’s the title of the movie (when 1 movie is selected)
- div.dvd-summary it’s the style of the summary of the movie
- div.dvd-detailsBody all the details of the movie are embed in this division. The modification written here will affect all the details
- div.dvd-multiple-title and "div.dvd-multiple-director" are used for title and director when there are more there a movie selected
- .borrowedStyle used to represent location of an item when it’s borrowed
- .placeStyle the name of the details ("Director:", "Summary:"…)
- .releaseDate used to represent the release date, when the movie or game hasn’t been released yet
5) Remane the file
Remane the file "Sample View.bundle" to "The Name of your view.bundle"
6) Testing the plug-in
To test the plug-in move the file into:
"~/Library/Application Support/Dvd_Hunter/Plug-Ins/" for Dvd Hunter
"~/Library/Application Support/Game_Hunter/Plug-Ins/" for Game Hunter
"~/Library/Application Support/Book_Hunter/Plug-Ins/" for Book Hunter
Relaunch the application.
Chose from Preferences->Graphics->Preview Style your view style
7) Sharing your work with others
If you want to share your work with other users:
- Compress the .bundle file in a .zip (Hunter Suite can only extract zip files)
- Upload it online
- Mail me the link of the file, with a little description of the plug-in. Your plug-in will appear in the plug-in manager so that others users can install and use it.
Sample HTML Code of The Preview
<div class="item">
<div class="dvd-title">007 Il mondo non basta</div>
<div class="dvd-detailsBody">
<div><span class="placeStyle">Regista:</span> Michael Apted</div>
<div><span class="placeStyle">Attori Principali:</span> Denise Richards, John Cleese, Judi Dench, Maria Grazia Cucinotta, Pierce Brosnan, Robert Carlyle, Sophie Marceau</div>
<div><span class="placeStyle">Genere:</span> Thriller</div>
<div class="dvd-summary">La nuova missione di James Bond è quella di proteggere Elektra, la bellissima figlia del magnate del petrolio Sir Robert King, recentemente assassinato da un efferato terrorista internazionale. Ma la ragazza sembra ancora minacciata dal suo aguzzino, un terrorista anarchico chiamato Renard: in realtà si trova proprio al centro di un intrigo internazionale volto a sovvertire l’ordine economico mondiale.</div>
<div>Joel's Shelf</div>
</div>
</div>