I would like to propose an initial documentation page for the Legal module. I have also attached the page in a .zip file. It is primarily based on the Readme.txt file:

Module: Legal
Author: Robert Castelo
Sponsor: Code Positive [www.codepositive.com]
Drupal: 6.0.x

This module displays your Terms & Conditions to users who want to register, and makes sure they accept the T&C before their registration is accepted.

Note: No T&C will be displayed until the T&C text has been input by the administrator.

Each time a new version of the T&C is created all users will be required to accept the new version.

Note: T&C text should only be entered by administrators or other highly trusted users. filter_xss_admin() is used to filter content for display, this is a very permissive XSS/HTML filter intended for admin-only use.

Integrates with Views, and ships with 2 default views that display T&C history, and user acceptance of T&Cs.

To install:

Note: It is assumed that you have Drupal up and running. Be sure to check the Drupal web site if you need assistance. If you run into problems, you should always read the INSTALL.txt that comes with the Drupal package and read the online documentation.

Dependencies: checkbox_validate Module for Drupal 6

  1. Place the entire legal directory into your Drupal modules/directory.
  2. Enable the legal module by navigating to:
    Administer > Site building > Modules
    Click the 'Save configuration' button at the bottom to commit your changes.

To configure:

  1. Go to Administer > User management > Access control
    Set which roles can "View Terms and Conditions".
    Set which roles can "Administer Terms and Conditions".
  2. Go to Administer > Site configuration > Legal
    Input your terms & conditions text.
    Set how you would like it displayed:
    • Scroll Box - Standard form text box (read only). Text is entered and displayed as text only.
    • Scroll Box (CSS) - Scrollable text box created in CSS. Text should be entered with HTML formatting. (less accessible than a standard scroll box)
    • HTML Text - Terms & conditions displayed as HTML formatted text.
    • Text should be entered with HTML formatting.


  3. Note: When displayed on the page at /legal, your T&Cs will be automatically reformatted to HTML Text if entered as a Scroll Box or Scroll Box (CSS).

  4. Page Link

FACEBOOK CONNECT

In facebook applications, click edit, click Facebook User Settings. Click "Do not create accounts Automatically". Then, when user DOES create account, it runs them through the Legal agreement.

ACKNOWLEDGEMENTS

  • Drupal 5 update sponsorship
    Lullabot (http://www.lullabot.com)
  • User data variables clean up
    Steven Wittens (Steven)
  • T&C Page formatting
    Bryant Mairs (Susurrus)
CommentFileSizeAuthor
#1 LegalVersion2.zip1.44 KBdtrack
LegalVersion1.zip1.44 KBdtrack

Comments

dtrack’s picture

StatusFileSize
new1.44 KB

After reviewing the HTML code, some taggs needed to be adjusted.
The better version is this:

Module: Legal
Author: Robert Castelo
Sponsor: Code Positive [www.codepositive.com]
Drupal: 6.0.x

This module displays your Terms & Conditions to users who want to register, and makes sure they accept the T&C before their registration is accepted.

Note: No T&C will be displayed until the T&C text has been input by the administrator.

Each time a new version of the T&C is created all users will be required to accept the new version.

Note: T&C text should only be entered by administrators or other highly trusted users. filter_xss_admin() is used to filter content for display, this is a very permissive XSS/HTML filter intended for admin-only use.

Integrates with Views, and ships with 2 default views that display T&C history, and user acceptance of T&Cs.

To install:

Note: It is assumed that you have Drupal up and running. Be sure to check the Drupal web site if you need assistance. If you run into problems, you should always read the INSTALL.txt that comes with the Drupal package and read the online documentation.

Dependencies: checkbox_validate Module for Drupal 6

  1. Place the entire legal directory into your Drupal modules/directory.
  2. Enable the legal module by navigating to:
    Administer > Site building > Modules
    Click the 'Save configuration' button at the bottom to commit your changes.

To configure:

  1. Go to Administer > User management > Access control
    Set which roles can "View Terms and Conditions".
    Set which roles can "Administer Terms and Conditions".
  2. Go to Administer > Site configuration > Legal
    Input your terms & conditions text.
    Set how you would like it displayed:
    • Scroll Box - Standard form text box (read only). Text is entered and displayed as text only.
    • Scroll Box (CSS) - Scrollable text box created in CSS. Text should be entered with HTML formatting. (less accessible than a standard scroll box)
    • HTML Text - Terms & conditions displayed as HTML formatted text. Text should be entered with HTML formatting.
    • Page Link

    • Note: When displayed on the page at /legal, your T&Cs will be automatically reformatted to HTML Text if entered as a Scroll Box or Scroll Box (CSS).

FACEBOOK CONNECT

In facebook applications, click edit, click Facebook User Settings. Click "Do not create accounts Automatically". Then, when user DOES create account, it runs them through the Legal agreement.

ACKNOWLEDGEMENTS

  • Drupal 5 update sponsorship
    Lullabot (http://www.lullabot.com)
  • User data variables clean up
    Steven Wittens (Steven)
  • T&C Page formatting
    Bryant Mairs (Susurrus)
ultimike’s picture

Don,

This is great. What you should do is go to http://drupal.org/documentation/modules/contributions, click on "Add child page" (near the bottom of the main content), then add this content there. When you're done, add a comment to this issue asking the Legal module maintainers to link to the new documentation page from the module's home page.

Make sense?

Thanks,
-mike

dtrack’s picture

I added a child page containing this code at:
http://drupal.org/node/1325026
Would it be possible for the Legal module maintainers to link to the new documentation child page at http://drupal.org/node/1325026 from the module's home page?
Thank you very much.

junedkazi’s picture

Project: Documentation » Legal
Version: » master
Component: Missing documentation » Documentation

Hi Robert

Can the documentation link be add to the module page.

robert castelo’s picture

Status: Needs review » Closed (fixed)

Thanks!

Done.