Difference between revisions of "TranscludeFilter"

From ARK
Jump to: navigation, search
(Example 1 - getting a saved filter)
(Example 1 - transcluding a saved filter as a table)
 
(2 intermediate revisions by one other user not shown)
Line 24: Line 24:
 
===Example===
 
===Example===
  
====Example 1 - getting a saved filter====
+
====Example 1 - transcluding a saved filter as a table====
  
http://your.ark.instance/api.php?req=getFilter&retftrset=3&handle=johndoe&passwd=johndoepassword&disp_mode=table
+
http://your.ark.instance/api.php?req=transcludeFilter&retftrset=3&handle=johndoe&passwd=johndoepassword&disp_mode=table
  
 
Example return (returned as HTML):
 
Example return (returned as HTML):
  
[[File:transcludedFilter.png|100px]]
+
[[File:transcludedFilter.png|500px]]

Latest revision as of 16:44, 29 November 2013

This method is used to return the results of a filter in a standard ARK results array. It can return the results of a saved filter or can be used to run a simple freetext search.

Path

http://your.ark.instance/api.php?req=transcludeFilter

Arguments

  • ftype - The filtertype. Currently only a free text search can be undertaken using the API. If you want to run a free text search ftype needs to be set to 'ftx'. You will also need to send a src.
  • src - This is the free text phrase to search on. Normal Boolean Search (i.e. Google) parameters apply.

If you want to retrieve a previously saved filter (saved using the ARK web interface) use:

  • retftrset - this needs to be set to the numeric id of a saved filter. Current saved filters can be queried using the API method describeFilters().
  • disp_mode - this is the display mode of the filter results - how the HTML will be rendered. The possible options are: chat, table, text, thumb, map. If no disp_mode is specified the results will be returned in table view.

If anonymous logins are not enabled a username and password will need to be supplied:

  • handle - username
  • passwd - password

Example

Example 1 - transcluding a saved filter as a table

http://your.ark.instance/api.php?req=transcludeFilter&retftrset=3&handle=johndoe&passwd=johndoepassword&disp_mode=table

Example return (returned as HTML):

TranscludedFilter.png