Custom Button Wikipedia - Setup
The purpose of this document is to describe how to setup a working custom button pointing to Wikipedia.
- Preparation of the environment
A/ Open your MusicMaster database and note down the field number values of the following field:
- XXX: field containing the Artist Keywords
Below please find a series of screenshots that will help you in the process.
Note: the field name and number may vary depending on the database used. Here it is called "Artist Keywords" and the field number is 104.
B/ Do you have the Wikipedia logo?
If not, you can find it below AND as an attachment to this document.
Once you have saved the above image as a .jpg file on your computer (or after downloading the attachment), you have to cut or copy it into your MusicMaster installation folder (the same which contains the file MusicMaster.exe).
C/ Don't you use Internet Explorer as default browser? If so, we suggest to start doing it. MusicMaster is developed, tested and supported within an IE environment, even if most of its functionalities work also with other browsers.
Done? Let's move on to the next step then.
- MusicMaster.ini file
This file is usually located in the MusicMaster installation directory.
Two possible cases here:
A/ MusicMaster.ini not present. In this case a new empty .ini file has to be created inside MusicMaster installation folder (remember? You already saved your Wikipedia logo in that folder!). Then you have to rename the file as "MusicMaster.ini".
Alternatively, you can download the .ini file attached to this document and modify it.
You have now to open it with a text editor and to copy-paste the following text into it:
;;;;;START_FILE;;;;;;
[UserButton1]
ToolTip=Wikipedia
Image=Wikipedia.jpg
Internal=1
URL=http://en.wikipedia.org/wiki/%FLD:104%
;;;;;END_FILE;;;;;;
Some explanation for the fields marked in red.
- "Internal=1" means that you want to launch Wikipedia within MusicMaster Web Browser Page. If you prefer to navigate via a full browser window (Internet Explorer), we suggest you to set this value to "0" or to remove this line from the above example.
- "%FLD:104%" Do you remember the screenshot which shows the artist keywords field number in MusicMaster? If so, you may remember that 104 was the resulting values in our sample database. Of course, things can be different in your database. In this case you will have to replace the number in red with the one noted down from your database..
B/ MusicMaster.ini already present. In this case you should open it with any text editor and add the following section:
;;;;;START_FILE;;;;;;
[UserButtonX]
ToolTip=Wikipedia
Image=Wikipedia.jpg
Internal=1
URL=http://en.wikipedia.org/wiki/%FLD:104%
;;;;;END_FILE;;;;;;
Some explanation for the fields marked in red.
- The "X" in the [UserButton] element definiton line has to replaced with an integer number. If you didn't have any UserButton in your .ini file, this number has to be 1; if you add already set up other customized buttons in your .ini file, you should insert a value equal to the highest one present in the .ini file + 1. Example: you already had two user buttons? X in this case should be equal to 3. Note: With MusicMaster 5.0 SR 15 you can add up to 5 User Buttons, so 5 is the maximum amount.
- "Internal=1" means that you want to launch Wikipedia within MusicMaster Web Browser Page. If you prefer to navigate via a full browser window, we suggest you to set this value to "0" or to remove this line from the above example.
- "%FLD:104%" Do you remember the screenshot which shows the artist keywords and title field number in MusicMaster? If so, you may remember that 104 and 103 where the resulting values in our sample database. Of course, things can be different in your database. In this case you will have to replace the number in red with the one noted down from your database..
- Let's give it a try!
Please close all the instances of MusicMaster and restart it. Open your database and you should now have a button identical to the one below:
If so, the only thing left, is to try it out. First, if you inserted "Internal=1" in the .ini file, you should make sure that the web browser view is ticked as showed below:
Now, just selecting a song from your library and clicking on the newly created "Wikipedia" button, you will have something like the picture below in the web browser window. You will see my Wikipedia is in English, but language will depend on your preferences. Moreover, if you have a Wikipedia accoun or you want to create one, you can do it all from within MusicMaster's Web Browser window.
Note: if you selected "Internal=0" or you removed that line from MusicMaster.ini file (see step 2 of this tutorial), a new window will automatically open in your browser each time you click on your Wikipedia button within MusicMaster.
- Done?
If the result is at least similar to the above picture, everything worked fine and you can read all the details about your artist on Wikipedia page as you like.
If you didn't get the expected result, do not hesitate to contact us at the following e-mail address: support@onair.de. We will be happy to help you setting up your environment!
Comments