This module allows you to display stock quotes from Yahoo Finance in a module position.

The stock quotes are obtained in "real-time" direct from Yahoo Finance. Note: as stated in the Yahoo Finance page, these quotes are delayed (for up to 15 to 20 minutes.), except where indicated otherwise.

The latest version now allows you to display the time in your local time, e.g. Hong Kong's Hang Seng Index in Hong Kong time. Please refer to here for details.

There are three demos available:

• Yahoo Stock Quote as module.
• Yahoo Stock Quote in content item - sample 1: The data for each symbol appears by columns.
• Yahoo Stock Quote in content item - sample 2: The data for each symbol appears by rows.

Note: I've turned off the automatic refresh in these demo so that the Yahoo Finance's server is not overloaded too much when too many users are trying out the demo all at the same time.

• Retrieves "real-time" stock quotes through Yahoo Finance API.
• Uses AJAX to display the result - no reloading of pages required!
• Automatic refresh of the latest stock quotes at user-defined interval.
• Full CSS support! This means that you can set the font family, font size, foreground and background color of the input field, submit button, symbols, stock quotes, etc.
• The module can be included in a content item! (see below for details)

You can display a single quote: e.g. YHOO.

Or you can display multiple quotes all at once: e.g. GOOG,MSFT,YHOO.

If you have entered "GOOG,MSFT,YHOO", you will see the following displayed:

You can turn on or off any of these fields. For example, you can choose to display only some of the fields:

And you can choose to display the symbols by row or by column. This is useful, for example, if you wish to display the stock quotes in the left or right module position.

The stock quote from Yahoo Finance are always displayed in ET time.

Global Time Offset

You can set a global time offset in the parameters page. All displayed time will be offset by this amount. Please refer to here for more details.

Local Time Offset

To do a local time offset, enter the following in search field:

^HSI(+13)

The +13 will auotmatically add 13 hours to the ET time.

For half-hour offset, use the following:

^HSI(+17:30)

^HSI(+12:45)

You can add some additional characters behind the time offset to indicate the time zone, e.g.

^HSI(+13HK)

Note that there is now "HK" appended behind the time. Note that the program WILL NOT automatically find out the difference between HK and ET time. You have to manually specify how many hours to add or subtract from the ET time.

You can have multiple offsets for different symbols, e.g.

YHOO,^HSI(+13HK),^N225(+14JP)

Of course, the module supports automatic refresh without any reloading of pages.

If your browser supports AJAX, the stock quotes will be refreshed once every 5 seconds. You can set this interval to be longer. But the minimal is 5 seconds. (Of course, technically you can even refresh at a rate of once every one milliseconds. However, if you do so, I think Yahoo will soon come after you for absuing their servers. That's why I set the fastest refresh rate to be 5 seconds.)

To turn off automatic refresh, set the interval to be 0.

Note that the automatic refresh will only work if your browser supports javascript and AJAX. If it doesn't, then the stock quotes will only be displayed when you first click the submit button. The stock quotes will not be updated or refreshed subsequently. You need to manually click the submit button again to get the latest stock quotes from Yahoo Finance.

If you click on any of the intraday thumbnail, it will bring you direct to the full graph at Yahoo Finance site:

The module will also work for non-javascript browser and browsers which do not allow javascript. For these browsers, since AJAX cannot run, there will be reloading of the page when the submit button is clicked. The same result will appear for both the AJAX and non-AJAX mode.

Since this is a standard Joomla module, you can easily include this module into a content item or article with the use of {mosloadposition} (for Joomla 1.0.x) or {loadposition} (for Joomla 1.5.x).

You can take a look at the demo here.

• For Joomla 1.0.x, pleaser refer to:
  How to include modules in Content item (for Joomla 1.0.x)?
• For Joomla 1.5.x, pleaser refer to:
  How to include modules in Content item (for Joomla 1.5.x)?

The Yahoo Stock Quote module is FREE to use (even on commercial websites) as long as the Powered by JoomlaGadgets links remain intact and visible.

1. Download and install the "Yahoo Stock Quote" module.
2. Make sure the module is published / enabled.
3. Select a module position where you want to place the module.

That's it! You're now ready to use the Yahoo Stock Quote right inside your Joomla website!

You can set the following in the Parameters page:

1. Use which method to retrieve data: There are now three methods to retrieve data from Yahoo Finance.
• The default method uses fread().
• You can also use file_get_contents(). Note that file_get_contents() is only available in PHP5 and above.
• Use the cURL library. For this method, you need to make sure your PHP has the cURL library installed.

Use the default method fread() first. If it doesn't work, then try file_get_contents(), and then the cURL library.

2. Size of input field: This is the size of the input field for users to enter the symbols.
3. Refresh frequency: This is the interval between each stock quotes refresh (in number of seconds). As noted above, the fastest refresh rate is once every 5 seconds.
4. Label for Submit Button: Default is "Get Quotes". You may change this to your language.
5. Layout style: There are currently two layout styles to choose from:

Style 1:	The stock quote for each symbol are listed by column.
Style 2:	The stock quote for each symbol are listed by row.

6. Date Format: This is the date format in PHP's date format. For example, if you're from UK, you can use d/m/y to display date format in dd/mm/yyyy.
7. Global Time Offset: The stock quote from Yahoo Finance are always displayed in ET time. If you are, say in UK, you can enter a +5 in this field to offset all time by +5 hours.
8. Global Time Zone Name: The stock quote from Yahoo Finance are always displayed in ET time. If you are, say in the Mountain Time (MT) time zone, you can enter an "MT" here so that all time is displayed as time+'MT'.
9. Hide Search Field: If you want to preset the symbols and do not want the users to enter other symbols, enter "Yes" here. The input field as well as the "Get Quotes" button will be hidden.
10. Selection and ordering of the fields: The rest of the fields are the available stock quotes information from Yahoo Finance. Please select your desired fields accordingly.

I've used the same method as that used in the ordering of modules/plugins in the Joomla admin page. You select and position a field by inputting an integer number 1, 2, 3, etc. A field with 0 will not be displayed. Note that the number need not be sequential, for example, you can also input 1, 10, 20, 30, 40, 100, 210, 300, etc.

The entire formatting of the stock quotes is done using CSS. If you do not like the default look and feel of the stock data, you can edit the following CSS file:

<your joomla root folder>/modules/mod_yahoostockquote/yahoostockquote.css

Note that in the stylesheet yahoostockquote.css, I've only used some of the possible styles.

In case you need even more control, below are listed some additional styles you can use. Just add these new styles to the file yahoostockquote.css.

1. Input Box

div.yahoostock input.inputbox {
	font-family: Verdana;
	font-size: 12pt;
	font-style: italic;
}

2. Submit Button

div.yahoostock input.button {
	font-family: Verdana;
	font-size: 10pt;
}

3. Use this if you wish to set the background color of the entire module block:

div.yahoostock {
	background: #33FF66;
}

• v1.0.1 (for Joomla 1.0) and v1.5.1 (for Joomla 1.5)
  Released September 16, 2008
• Stock quotes will now be displayed when the module is first loaded (without the need to press the Submit button).
• Don't forget to define the parameter Default Symbols in the Module Manager. This is the initial list of symbols to be displayed when the module is first loaded.

• v1.0.2 (for Joomla 1.0) and v1.5.2 (for Joomla 1.5)
  Released September 17, 2008
• Changed the progress.gif to a smaller size so that there is no displacement of layouts when the animated gif is displayed via AJAX.
• You can now use your own animated gif for the "loading-in-progress" image when the module is retrieving data from Yahoo. The filename of the animated gif is specified in the parameters page of the Module Manager, and the animated gif should be placed in the folder <joomla_root>/modules/mod_yahoostockquote.
• I've included one additional animated gif called "progressbar.gif": . Use this if the width of your module is large enough. If you are using the module in the left or right module position, use the default progress image:
• If you find the animated gif distracting, you can suppress this altogether in the parameters page.

• v1.0.3 (for Joomla 1.0) and v1.5.3 (for Joomla 1.5)
  Released September 23, 2008

Thanks to Karen who informed about the "Division by zero" error when the previous trade value is zero. This sometimes occurs when Yahoo Finance reset these values a few hours before the market opens.

Have fixed the code so that there will not be any "Division by zero" error.

• v1.0.4 (for Joomla 1.0) and v1.5.4 (for Joomla 1.5)
  Released January 20, 2009

This is in response to Achdw's request to be able to display local time for the Yahoo stock quotes, for example, to display Hong Kong's Hang Seng Index in Hong Kong time

The latest version now supports this. Please refer to here for details.

• v1.0.5 (for Joomla 1.0) and v1.5.5 (for Joomla 1.5)
  Released January 24, 2009

Bug fix: you can now specify the fields to be displayed again. Thanks to Elie for highlighting the bug.

• v1.0.6 (for Joomla 1.0) and v1.5.6 (for Joomla 1.5)
  Released April 8, 2009

Bug fix: v1.5.6 fixed line 297 $row is redundant.

• v1.0.7 (for Joomla 1.0) and v1.5.7 (for Joomla 1.5)
  Released Jun 26, 2009

Thanks to Andrew to provide me with the list of additional yahoo stock quote APIs. The new version now allows you to display a lot more financial info such as P/E ratio, Earnings per share (EPS), market cap, etc.

The new version also incorporates some of the feature requests from users:

• read yahoo data by CURL, file_get_contents() or fread()
• display of symbol name from Yahoo e.g. ^N225 is NIKKEI 225, ^HSI is HANG SENG INDEX
• date format e.g. for those in UK, you can now use j/n/Y to display dates in d/m/yyyy
• added global time offset e.g. for those in UK, you can use a global time offset of +5
• added global time zone name, e.g. for those using mountain time, you can set this as MT
• provides link to different charts: 1d, 5d, 1m, ytd, 1y, 2y, 5y
• now links to yahoo interactive chart instead of basic chart
• you can now hide the search field and submit button
• allow you to set the order of the display fields (similar to setting the order of Joomla modules in the admin page)
• v1.0.8 (for Joomla 1.0) and v1.5.8 (for Joomla 1.5)
  Released August 31, 2009

This is in response to Redback's request to have time offset in half hours e.g. South Australian time is +9.30 GMT.

Please refer to here for details.