README.txt

CONTENTS OF THIS FILE
---------------------

 * Introduction
 * Installation
 * Usage


INTRODUCTION
------------

Current Maintainer: The White House <https://drupal.org/u/whitehouse>

This module provides a form (with a block implementation) for posting signatures
to a petitions <https://drupal.org/project/petitions> website like the White
House's "We the People" <https://petitions.whitehouse.gov/> application.


INSTALLATION
------------

Petitions Signature Form requires version 2.x of the Libraries module
<https://drupal.org/project/libraries>, and it needs the Petitions PHP SDK
<https://github.com/WhiteHouse/petitions-php-sdk/> installed at
sites/all/libraries/petitions-php-sdk. The module itself is installed in the
usual way. See http://drupal.org/documentation/install/modules-themes/modules-7.
It must be configured at admin/config/services/petitionssignatureform to talk to
a Petitions <https://drupal.org/project/petitions> API endpoint.


USAGE
-----

A Petitions signature form can be placed on your site via the provided
"Petitions signature form" block or programmatically in PHP:

 * Place the "Petitions signature form" block as you would any other, e.g., via
   the core Blocks interface at admin/structure/block or using Panels
   <https://drupal.org/project/panels> or Context
   <https://drupal.org/project/context>. You must configure the block to know
   where to get the ID of the petition it should sign or it will present a
   "Petition ID" field to the end user.

 * Place the form programmatically using code like the following in your module
   or theme:

   <?php
   $form = drupal_get_form('petitionssignatureform_signature_form', $petition_id);
   print drupal_render($form);
   ?>