Difference between revisions of "Mobile Key"

From Biowikifarm Metawiki
Jump to: navigation, search
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
Mobile Key is a Wiki extension with the purpose to export wiki keys as html pages for mobile applications, using the key data harvested by the extension [[Template Parameter Index]].
 
Mobile Key is a Wiki extension with the purpose to export wiki keys as html pages for mobile applications, using the key data harvested by the extension [[Template Parameter Index]].
  
 +
==Installation==
  
 +
The extension [[Template Parameter Index]] must be installed first.
 +
In your $IP/extensions folder create a Mobile Key folder, and decompress the files of the Mobile Key extension to this folder. Also create a folder called MobileKey in <code>$wgScriptPath/media/</code>(this is the default <code>$wgMobileKeyFilePath</code>, with <code>$wgMobileKeyFileDirectory = $IP/media/MobileKey/</code>, they can be overwritten in LocalSettings.php).
 +
Install the extension by adding to LocalSettings.php:
 +
  include_once("$IP/extensions/MobileKey/MobileKey.php");
  
−
==Wiki file resolver==
+
$wgGroupPermissions['user']['mobilekey'] = true;
 +
 +
is set as default group Permissions. This can also be overwritten in LocalSettings.php.
  
−
Mediawiki stores its files inside a repository structure, that uses MD5 hashes as part of the file name. This makes direct access to a binary file (image etc.) slightly difficult if you only know the wiki-name of the file (like File:XY.jpg). However, mediawiki also may be configured to use a series of external repositories, including wikimedia commons. When resolving a file like XY.jpg, mediawiki will go through the repository definitions, and returns the file from the first repository containing a name of this file. This behavior is impossible to re-implement without detailed knowledge about the attached repositories.
+
==Usage==
  
−
As a solution, the Mobile Key extension offers a web service that may also be used independently of mobile key developing. This service resolves wiki file names (the binary files for which which may come from local or a variety of attached repositories). It offers the two functions: action=getMediaURL (return URL as string) and action=getMediaFile (directly resolve Media file).
+
The extension creates a [[Special:MobileKey|Special Page "Mobile Key"]] (see [http://biowikifarm.net/test/Special:MobileKey here] for testwiki). On this page the user can enter the name of the wiki page that contains the wiki key. On clicking the "Show" button the html pages with the wiki key are created, including recursively keys that are linked as identification results. These and also the images are stored on the server, and a zip archive is created. The latter can be downloaded by clicking the "Download" button. If the file format is not supported by a mobile device, files can be downloaded on and then copied from a PC.  
  
−
The first returns a single string, which is the URL to the media file, setting MIME type to text, the second returns the binary media file, setting MIME type to image/xxx. Optionally a width parameter can be set for both, in which case a thumb will be dynamically rendered.
+
For instructions how to copy offline keys to various Smartphones see the [http://www.keytonature.eu/wiki/Installing_offline_keys_on_mobile_phones Key to Nature page].
  
−
Examples:
+
==Wiki file resolver==
−
+
−
From ForeignAPIRepo wikimediacommons:
+
−
http://biowikifarm.net/metawiki/index.php?title=Special:MobileKey&action=getMediaURL&objectName=File:PelobatesFuscus.jpg
+
−
http://biowikifarm.net/metawiki/index.php?title=Special:MobileKey&action=getMediaFile&objectName=File:PelobatesFuscus.jpg&width=200
+
−
 
+
−
From ForeignDBRepos:
+
−
http://biowikifarm.net/metawiki/index.php?title=Special:MobileKey&action=getMediaURL&objectName=File:Blatt%20gelappt.svg&width=400
+
−
http://biowikifarm.net/metawiki/index.php?title=Special:MobileKey&action=getMediaFile&objectName=File:Blatt%20gelappt.svg&width=400
+
−
http://biowikifarm.net/metawiki/index.php?title=Special:MobileKey&action=getMediaURL&objectName=File:Mauerraute.jpg&width=200
+
−
http://biowikifarm.net/metawiki/index.php?title=Special:MobileKey&action=getMediaFile&objectName=File:Mauerraute.jpg
+
  
 +
see [[Wiki File Resolver]]
  
 
[[Category: Software documentation]]
 
[[Category: Software documentation]]

Latest revision as of 07:52, 20 October 2010

Mobile Key is a Wiki extension with the purpose to export wiki keys as html pages for mobile applications, using the key data harvested by the extension Template Parameter Index.

Installation

The extension Template Parameter Index must be installed first. In your $IP/extensions folder create a Mobile Key folder, and decompress the files of the Mobile Key extension to this folder. Also create a folder called MobileKey in $wgScriptPath/media/(this is the default $wgMobileKeyFilePath, with $wgMobileKeyFileDirectory = $IP/media/MobileKey/, they can be overwritten in LocalSettings.php). Install the extension by adding to LocalSettings.php: 

 include_once("$IP/extensions/MobileKey/MobileKey.php");

$wgGroupPermissions['user']['mobilekey'] = true; 

is set as default group Permissions. This can also be overwritten in LocalSettings.php.

Usage

The extension creates a Special Page "Mobile Key" (see here for testwiki). On this page the user can enter the name of the wiki page that contains the wiki key. On clicking the "Show" button the html pages with the wiki key are created, including recursively keys that are linked as identification results. These and also the images are stored on the server, and a zip archive is created. The latter can be downloaded by clicking the "Download" button. If the file format is not supported by a mobile device, files can be downloaded on and then copied from a PC.

For instructions how to copy offline keys to various Smartphones see the Key to Nature page.

Wiki file resolver

see Wiki File Resolver

Retrieved from "https://biowikifarm.net/metawiki/index.php?title=Mobile_Key&oldid=3200"