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
- Place the entire legal directory into your Drupal modules/directory.
- 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:
- Go to Administer > User management > Access control
Set which roles can "View Terms and Conditions".
Set which roles can "Administer Terms and Conditions". - 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)
| Comment | File | Size | Author |
|---|---|---|---|
| #1 | LegalVersion2.zip | 1.44 KB | dtrack |
| LegalVersion1.zip | 1.44 KB | dtrack |
Comments
Comment #1
dtrack commentedAfter 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
Administer > Site building > Modules
Click the 'Save configuration' button at the bottom to commit your changes.
To configure:
Set which roles can "View Terms and Conditions".
Set which roles can "Administer Terms and Conditions".
Input your terms & conditions text.
Set how you would like it displayed:
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
Lullabot (http://www.lullabot.com)
Steven Wittens (Steven)
Bryant Mairs (Susurrus)
Comment #2
ultimikeDon,
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
Comment #3
dtrack commentedI 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.
Comment #4
junedkazi commentedHi Robert
Can the documentation link be add to the module page.
Comment #5
robert castelo commentedThanks!
Done.