Search scripts - Revision history

RubnÊ”: Add Existing scripts

2009-06-29T10:40:40Z

Add Existing scripts

← Older revision		Revision as of 10:40, 29 June 2009
Line 40:		Line 40:

	This procedure is called when this search script should terminate all its actions and destroy all created user interface elements. '''Panel''' parameter is the same as in case of ''StartSearch'' procedure.		This procedure is called when this search script should terminate all its actions and destroy all created user interface elements. '''Panel''' parameter is the same as in case of ''StartSearch'' procedure.

			===Some existing scripts===

			* [http://www.mediamonkey.com/forum/viewtopic.php?f=2&t=28649&hilit=Auto+tag+Web+Search Discogs Auto-tag Web Search]
			* [http://www.mediamonkey.com/forum/viewtopic.php?f=2&t=34267&start=0&st=0&sk=t&sd=a&hilit=Auto+tag+Web+Search MusicBrainz Tagger]
			* [http://www.mediamonkey.com/forum/viewtopic.php?f=2&t=30994&start=0&st=0&sk=t&sd=a&hilit=Auto+tag+Web+Search MusicIP Tagger]

Jiri: /* Search script basics */

2007-04-10T16:00:36Z

Search script basics

← Older revision		Revision as of 16:00, 10 April 2007
Line 4:		Line 4:

	Each search script must be in a separate file (usually .vbs) and must contain several procedures that MediaMonkey calls. The script remains loaded in memory during the whole life of searching (i.e. starting from initialization of a search until user choosed different search method or searches for something else). Therefore you can use global script variables and keep values in them among calls to the procedures of script.		Each search script must be in a separate file (usually .vbs) and must contain several procedures that MediaMonkey calls. The script remains loaded in memory during the whole life of searching (i.e. starting from initialization of a search until user choosed different search method or searches for something else). Therefore you can use global script variables and keep values in them among calls to the procedures of script.

			Each search script must be included in Scripts.ini file and designated as ScriptType=3.

	===Search script structure===		===Search script structure===

Jiri: Finished the article

2007-04-10T14:15:54Z

Finished the article

← Older revision		Revision as of 14:15, 10 April 2007
Line 8:		Line 8:

	Each search script must contain several procedures so that it can properly respond to what user and MediaMonkey want from it. The required procedures are:		Each search script must contain several procedures so that it can properly respond to what user and MediaMonkey want from it. The required procedures are:


	====Sub StartSearch( Panel, SearchTerm, SearchArtist, SearchAlbum)====		====Sub StartSearch( Panel, SearchTerm, SearchArtist, SearchAlbum)====
Line 29:		Line 30:
	====Sub ShowResult( ResultID)====		====Sub ShowResult( ResultID)====

			This procedure is called whenever user changes the result to be shown in the top panel drop-down control, i.e. when another album should be shown. This is also called automatically right after [[ISDBWebSearch::SetSearchResults]] is called, in such case ResultID is 0, indicating that the very first search result should be shown, otherwise it contains the index of search result to be shown (up to number of results set by [[ISDBWebSearch::SetSearchResults]]).

			This procedure also has to indicate to MediaMonkey how fields would be changed in case user presses Auto-tag button. Use [[ISDBWebSearch::SmartUpdateTracks]], [[ISDBWebSearch::NewTracks]], [[ISDBWebSearch::AlbumArtURL]] and [[ISDBWebSearch::RefreshViews]] methods for this purpose.


	====Sub FinishSearch( Panel)====		====Sub FinishSearch( Panel)====

			This procedure is called when this search script should terminate all its actions and destroy all created user interface elements. '''Panel''' parameter is the same as in case of ''StartSearch'' procedure.

Jiri: Fixed formatting

2007-04-10T14:04:09Z

Fixed formatting

← Older revision		Revision as of 14:04, 10 April 2007
Line 12:		Line 12:

	This procedure initializes the whole search. It's called only once when search is started. Its parameters are:		This procedure initializes the whole search. It's called only once when search is started. Its parameters are:
	:Panel		;Panel
	;Object of [[SDBUITranspPanel]] where you can place the controls showing results. Usually, e.g. in [[Sample AMG Search script]], it is [[SDBUIActiveX]] control containing a web browser.		:Object of [[SDBUITranspPanel]] where you can place the controls showing results. Usually, e.g. in [[Sample AMG Search script]], it is [[SDBUIActiveX]] control containing a web browser.
	:SearchTerm		;SearchTerm
	;The term user searches for. In case the search string wasn't entered by the user, it's a compilation of Artist and Album values (with some useless characters removed).		:The term user searches for. In case the search string wasn't entered by the user, it's a compilation of Artist and Album values (with some useless characters removed).
	:SearchArtist		;SearchArtist
	;Artist extracted from tracks that are being search for. In case the search is initiated by user entering a search string, this value is empty.		:Artist extracted from tracks that are being search for. In case the search is initiated by user entering a search string, this value is empty.
	:SearchAlbum		;SearchAlbum
	;Album extracted from tracks that are being search for. In case the search is initiated by user entering a search string, this value is empty.		:Album extracted from tracks that are being search for. In case the search is initiated by user entering a search string, this value is empty.


	In case you need details about the tracks that are being searched, use [[ISDBWebSearch::NewTracks]] property to access individual tracks.		In case you need details about the tracks that are being searched, use [[ISDBWebSearch::NewTracks]] property to access individual tracks.

			When search results are returned, you should use [[ISDBWebSearch::SetSearchResults]] to let MediaMonkey know about it.


			====Sub ShowResult( ResultID)====



			====Sub FinishSearch( Panel)====

Jiri at 13:59, 10 April 2007

2007-04-10T13:59:08Z

New page

Search scripts let developers to plug-in new search types into Auto-tag from Web dialog (formerly Auto-tag from Amazon). You can learn most about them from a well commented [[Sample AMG Search script]]. This script type was introduced in MediaMonkey 3.0.

===Search script basics===

Each search script must be in a separate file (usually .vbs) and must contain several procedures that MediaMonkey calls. The script remains loaded in memory during the whole life of searching (i.e. starting from initialization of a search until user choosed different search method or searches for something else). Therefore you can use global script variables and keep values in them among calls to the procedures of script.

===Search script structure===

Each search script must contain several procedures so that it can properly respond to what user and MediaMonkey want from it. The required procedures are:

====Sub StartSearch( Panel, SearchTerm, SearchArtist, SearchAlbum)====

This procedure initializes the whole search. It's called only once when search is started. Its parameters are:
:Panel
;Object of [[SDBUITranspPanel]] where you can place the controls showing results. Usually, e.g. in [[Sample AMG Search script]], it is [[SDBUIActiveX]] control containing a web browser.
:SearchTerm
;The term user searches for. In case the search string wasn't entered by the user, it's a compilation of Artist and Album values (with some useless characters removed).
:SearchArtist
;Artist extracted from tracks that are being search for. In case the search is initiated by user entering a search string, this value is empty.
:SearchAlbum
;Album extracted from tracks that are being search for. In case the search is initiated by user entering a search string, this value is empty.

In case you need details about the tracks that are being searched, use [[ISDBWebSearch::NewTracks]] property to access individual tracks.