You are here

README.txt in Legal 7

Same filename and directory in other branches
  1. 5 README.txt
  2. 6.8 README.txt
  3. 6.7 README.txt
  4. 7.2 README.txt
********************************************************************
D R U P A L    M O D U L E
********************************************************************
Name: Legal Module
Author: Robert Castelo
Sponsor: Code Positive [www.codepositive.com]
Drupal: 7.0.x
********************************************************************
DESCRIPTION:

    A module which 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.

   Tokens can be used in T&C text.


 ********************************************************************
INSTALLATION:

    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: none

    Place the entire legal directory into your Drupal modules/directory.
    Enable the Legal module by navigating to: Administer > Modules > Other > Legal

    Click the 'Save configuration' button at the bottom to commit your changes.

********************************************************************
CONFIGURATION:

    There are two ways to set permissions:

        1. Go to Administer > Modules > Other > Legal, under the "Operations" column click the "Permissions" link
            Set which roles can "View Terms and Conditions".
            Set which roles can "Administer Terms and Conditions".
        2. Go to Administer > People > Permissions
            Set which roles can "View Terms and Conditions".
            Set which roles can "Administer Terms and Conditions".

        Click the 'Save permissions' button at the bottom to commit your changes.

    There are two ways to configure the Legal module:

        1. Go to Administer > Modules > Other > Legal, under the "Operations" column click the "Configure" link
            Input your terms & conditions text.
        2. Go to Administer > People > 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).

    Click the 'Save' button at the bottom to commit your changes.


********************************************************************
ADDITIONAL CONFIGURATION

ADDITIONAL CHECKBOXES
Each field that contains text will be shown as a checkbox which the user must tick to register.
For example, if you enter "I am at least 18 years of age" in the text area, this will display as an additional checkbox,
which must be ticked in order to proceed.

EXPLAIN CHANGES
Explain what changes were made to the T&C since the last version.
This will only be shown to users who accepted a previous version (authenticated users).
Each line will automatically be shown as a bullet point.

FACEBOOK CONNECT

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

VARNISH CACHE

Some users have reported that when a user who hasn't accepted the
latest version of the legal terms attempts to login, they are logged
out with the message 'Operation timed out. Please try to log in again.'

To fix this please add the following to your default.vcl file:

sub vcl_recv {
  if (req.url ~ "^/legal_accept") {
    return (pipe);
  }
}


********************************************************************
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)




File

README.txt
View source
  1. ********************************************************************
  2. D R U P A L M O D U L E
  3. ********************************************************************
  4. Name: Legal Module
  5. Author: Robert Castelo
  6. Sponsor: Code Positive [www.codepositive.com]
  7. Drupal: 7.0.x
  8. ********************************************************************
  9. DESCRIPTION:
  10. A module which displays your Terms & Conditions to users who want to
  11. register, and makes sure they accept the T&C before their registration
  12. is accepted.
  13. Note: No T&C will be displayed until the T&C text has been input by
  14. the administrator.
  15. Each time a new version of the T&C is created all users will be required to
  16. accept the new version.
  17. Note: T&C text should only be entered by administrators or other highly trusted users.
  18. filter_xss_admin() is used to filter content for display, this is a very permissive
  19. XSS/HTML filter intended for admin-only use.
  20. Integrates with Views, and ships with 2 default views that display T&C history, and user
  21. acceptance of T&Cs.
  22. Tokens can be used in T&C text.
  23. ********************************************************************
  24. INSTALLATION:
  25. Note: It is assumed that you have Drupal up and running. Be sure to
  26. check the Drupal web site if you need assistance. If you run into
  27. problems, you should always read the INSTALL.txt that comes with the
  28. Drupal package and read the online documentation.
  29. Dependencies: none
  30. Place the entire legal directory into your Drupal modules/directory.
  31. Enable the Legal module by navigating to: Administer > Modules > Other > Legal
  32. Click the 'Save configuration' button at the bottom to commit your changes.
  33. ********************************************************************
  34. CONFIGURATION:
  35. There are two ways to set permissions:
  36. 1. Go to Administer > Modules > Other > Legal, under the "Operations" column click the "Permissions" link
  37. Set which roles can "View Terms and Conditions".
  38. Set which roles can "Administer Terms and Conditions".
  39. 2. Go to Administer > People > Permissions
  40. Set which roles can "View Terms and Conditions".
  41. Set which roles can "Administer Terms and Conditions".
  42. Click the 'Save permissions' button at the bottom to commit your changes.
  43. There are two ways to configure the Legal module:
  44. 1. Go to Administer > Modules > Other > Legal, under the "Operations" column click the "Configure" link
  45. Input your terms & conditions text.
  46. 2. Go to Administer > People > Legal
  47. Input your terms & conditions text.
  48. Set how you would like it displayed:
  49. - Scroll Box - Standard form text box (read only). Text is entered and displayed as text only.
  50. - Scroll Box (CSS) - Scrollable text box created in CSS.
  51. Text should be entered with HTML formatting. (less accessible than a standard scroll box)
  52. - HTML Text - Terms & conditions displayed as HTML formatted text.
  53. Text should be entered with HTML formatting.
  54. - Page Link
  55. Note: When displayed on the page at /legal, your T&Cs will be automatically reformatted to HTML Text
  56. if entered as a Scroll Box or Scroll Box (CSS).
  57. Click the 'Save' button at the bottom to commit your changes.
  58. ********************************************************************
  59. ADDITIONAL CONFIGURATION
  60. ADDITIONAL CHECKBOXES
  61. Each field that contains text will be shown as a checkbox which the user must tick to register.
  62. For example, if you enter "I am at least 18 years of age" in the text area, this will display as an additional checkbox,
  63. which must be ticked in order to proceed.
  64. EXPLAIN CHANGES
  65. Explain what changes were made to the T&C since the last version.
  66. This will only be shown to users who accepted a previous version (authenticated users).
  67. Each line will automatically be shown as a bullet point.
  68. FACEBOOK CONNECT
  69. In facebook applications, click edit, click on Facebook User Settings.
  70. Click on "Do not create accounts Automatically". Then, when user DOES
  71. create account, it runs them through the Legal agreement.
  72. VARNISH CACHE
  73. Some users have reported that when a user who hasn't accepted the
  74. latest version of the legal terms attempts to login, they are logged
  75. out with the message 'Operation timed out. Please try to log in again.'
  76. To fix this please add the following to your default.vcl file:
  77. sub vcl_recv {
  78. if (req.url ~ "^/legal_accept") {
  79. return (pipe);
  80. }
  81. }
  82. ********************************************************************
  83. ACKNOWLEDGEMENTS
  84. * Drupal 5 update sponsorship
  85. Lullabot (http://www.lullabot.com)
  86. * User data variables clean up
  87. Steven Wittens (Steven)
  88. * T&C Page formatting
  89. Bryant Mairs (Susurrus)