Drupal Plings module
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


// $Id$


Plings is a source of information about brilliant, inspiring places to go and
stuff to do for everyone aged 13-19. For more information about Plings see

This module provides support for querying the Plings API and displaying the
returned activities in a users area. It provides a default View that has a
block and a page display that can be configured further.

Getting a Plings API key
Plings will not work without an API key, for more information on how to obtain
one see http://www.plings.info/wiki/index.php/API_Keys#Register_for_a_Key

Supported methods of detecting user location
There are many ways to capture information about the location of a user in
Drupal, Plings needs to know how your site does it! Currently the following
methods are supported:

  * location, location_user module - http://drupal.org/project/location

Plings requires the following additional contributed modules:

  * views - http://drupal.org/project/views

NB. location, location_user are not dependencies but are currently the only
supported methods of detecting user location.

Plings relies on cron - for more information about setting up and/or running
cron see - http://drupal.org/getting-started/6/install/cron

Place the plings directory in your sites modules directory - usually this is
located at sites/all/modules.
Go to Administer -> Site building -> Modules and find Plings in the list of
Tick the checkbox next to Plings and click the Save configuration button.

Go to Administer -> Site configuration -> Plings.
Enter your Plings API key.
Select a Limit - this value is the maximum number of Plings that will be
returned when a call is made to the Plings API.
Select a Period - this is the period of Plings that will be returned from the
Plings API and represents days:
  0 = Today
  1 = Today and tomorrow
  2 = Today, tomorrow and the day after
  7 = The coming week.

Select the User location detection method.
Click Save configuration.
Select the Filter type - whether to filter by town or postcode.
Click Save configuration.
Go to Administer -> Reports -> Status report and click on the run cron
manually link.
Go to Administer -> Site building -> Views and enable the Plings default view.
Go to Administer -> Site building -> Blocks and enable the plings: Block.

Go to Administer -> Site building -> Modules and find Plings in the list of
Make sure the checkbox next to Plings is unticked and click the Save
configuration button - this effectively disables the Plings module but will not
remove your settings and will not remove the Plings database tables.
To fully uninstall Plings, you will need to take the extra steps of clicking
the Uninstall tab (on the same page, Administer -> Site building -> Modules),
ensure the checkbox next to Plings is ticked then click the Uninstall button.
Confirm you wish to continue uninstalling Plings when prompted.