Difference between revisions of "Template:DJISource"

From Geohashing
imported>NuclearDog
imported>NuclearDog
Line 1: Line 1:
 +
<includeonly>
 
== {{{hostname}}} ==
 
== {{{hostname}}} ==
  
Line 13: Line 14:
 
{{{accessRestrictions}}}
 
{{{accessRestrictions}}}
  
Contact: {{ #if: {{{contactAccount|}}} | [[User:{{{contactAccount}}}]] | Unknown }}
+
Contact: {{ #if: {{{contactAccount|}}} | [[User:{{{contactAccount}}}|{{{contactAccount}}}]] | Unknown }}
 +
</includeonly>
 +
<noinclude>
 +
 
 +
== Description ==
 +
 
 +
This is used to render entries on the [[Dow Jones Industrial Average]] page.
 +
 
 +
== Valid Fields ==
 +
 
 +
Valid fields are:
 +
* '''hostname''': The hostname (eg: irc.peeron.net, xkcd.nucleardog.com)
 +
* '''url''': The URL to retrieve the value at using tokens as described on the [[Dow Jones Industrial Average]] page to show where to place the year/month/day/etc.
 +
* '''urlComments''' (optional): Comments about the URL, such as "Leading zeros are not significant." or "Pass the GET variable X to accomplish function Y."
 +
* '''startDate''': When the source's records start at.
 +
* '''endDate''' (optional): When the records end at or leave it out of the source is still updating and kept current.
 +
* '''updateSource''': The hostname from which the source retrieves it's DJI value (eg: finanace.google.com)
 +
* '''updateFrequency''': The frequency with which the host is updated.
 +
* '''serverLocation''': Where (geographically) the server is located.
 +
* '''accessRestrictions''': Public? Ask first? Limit to queries? Put it in in plain english.
 +
* '''contactAccount''': The wiki account that you can contact with regard to this source.
 +
 
 +
== Example ==
 +
 
 +
{{DJISource
 +
|hostname=xkcd.nucleardog.com
 +
|url=http://xkcd.nucleardog.com/getdow.php?year=%Y&month=%m&day=%d
 +
|urlComments=Leading zeros are not significant in year, month and day values. If you request a date which has no value it will return the string 'null'. If you would like to avoid it returning 'null' when requesting days such as weekends, you may pass the GET variable 'compensate' with any value, which will cause it to work backwards from any non-existent days until it finds one with a value and return that instead.
 +
|startDate=1970-01-02
 +
|updateSource=finance.google.com
 +
|updateFrequency=hour
 +
|serverLocation=Texas, United States
 +
|accessRestrictions=Free for anyone to use up to a reasonable volume. If you need to make tens of thousands of requests daily, feel free to contact me and I'll send you a dump of the database and the update script.
 +
|contactAccount=NuclearDog}}
 +
 
 +
</noinclude>

Revision as of 08:04, 22 May 2008


Description

This is used to render entries on the Dow Jones Industrial Average page.

Valid Fields

Valid fields are:

  • hostname: The hostname (eg: irc.peeron.net, xkcd.nucleardog.com)
  • url: The URL to retrieve the value at using tokens as described on the Dow Jones Industrial Average page to show where to place the year/month/day/etc.
  • urlComments (optional): Comments about the URL, such as "Leading zeros are not significant." or "Pass the GET variable X to accomplish function Y."
  • startDate: When the source's records start at.
  • endDate (optional): When the records end at or leave it out of the source is still updating and kept current.
  • updateSource: The hostname from which the source retrieves it's DJI value (eg: finanace.google.com)
  • updateFrequency: The frequency with which the host is updated.
  • serverLocation: Where (geographically) the server is located.
  • accessRestrictions: Public? Ask first? Limit to queries? Put it in in plain english.
  • contactAccount: The wiki account that you can contact with regard to this source.

Example

xkcd.nucleardog.com
Date Range:1970-01-02 - present
Update Source:finance.google.com
Update Frequency:hour
Server Location:Texas, United States
Contact:NuclearDog

The source can be accessed at:

http://xkcd.nucleardog.com/getdow.php?year=%Y&month=%m&day=%d
  • Leading zeros are not significant in year, month and day values. If you request a date which has no value it will return the string 'null'. If you would like to avoid it returning 'null' when requesting days such as weekends, you may pass the GET variable 'compensate' with any value, which will cause it to work backwards from any non-existent days until it finds one with a value and return that instead.
  • Access Restrictions: Free for anyone to use up to a reasonable volume. If you need to make tens of thousands of requests daily, feel free to contact me and I'll send you a dump of the database and the update script.