$Id$

CONTENTS OF THIS FILE
---------------------
 * Introduction
 * Requirements
 * Installation
 * Other configuration
 * Credits
 

INTRODUCTION
------------
Lottery Block (http://drupal.org/project/lottery_block) adds a block with scrolling lottery results from one of 44 US states (including District of Columbia) that have lotteries.
It uses the Pausing up-down Scroller script from Dynamic Drive (www.dynamicdrive.com) to show your state's lottery results for the week. It utilizes the free RSS feeds from
US-Lotteries (www.us-lotteries.com) for the data.


REQUIREMENTS
------------
This module requires that you have allow_url_fopen set to "On" in php.ini on your server as it opens remote RSS (XML) files for it's data.
It also requires the "Pausing up-down Scroller" script from Dynamic Drive (pausescroller.js is included in module directory). The original script can be found at
Dynamic Drive here: http://www.dynamicdrive.com/dynamicindex2/crosstick.htm


INSTALLATION
------------
1. Copy the entire lottery_block project directory (not just the contents) to your 
   normal module directory (ie: sites/all/modules)
   
2. Enable the Lottery Block module at ?q=admin/build/modules

3. Visit ?q=admin/build/block and choose 'configure' for Lottery Block
   # Lottery State:
     * Using the select box, choose the state you wish to display results for.
   
   # Pause Delay:
     * Choose the length you would like the scroller to use when pausing between each game
       result. This is in milliseconds, i.e., 3500 would be 3.5 seconds.
   
   # Show State Header:
     * Check this to show a header above the scroller with the text:
             Lottery Results for [STATE]
       (Where [STATE] is the name of the state chosen for results)
   
   # Use Two Line Header:
     * Check this to split the State Header above into two lines with the first line being
       "Lottery Results for" and the next line being the chosen state name. (This is here
       for those needing to break it up for a narrow column or long state name, though the
       entire header is contained in one CSS class)
   
   # Footer Text:
     * Use this if you would like to have some text below the scroller. Initially set to
       "Mouseover To Pause" at installation, this can be anything you like. (Limit 40 characters)
   
   # Show US-Lotteries Analysis Link
     * When checked, this will show the last RSS item from US-Lotteries as a link to their site
       that will show a two month widget so users can look up past lottery game results. The
       link opens in a new window/tab. If unchecked, the last item will be the last lottery game
       result and will skip the analysis link and just restart the scroller.


OTHER CONFIGURATION
-------------------
Title, date and lottery number styles can be customized in lottery_block.css found in the module
directory and can be overridden by copying it to your theme directory.

    
CREDITS
-------
Developer and maintainer: Darrell Fox (Artman) ( http://drupal.org/user/176828 )

I had this scroller running on my old site and couldn't find one for Drupal when I switched over
so I wrote this as my very first Drupal module. ;)

I thought I would share it with the Drupal community and maybe someone else will find it useful
for their site.