You are here

Home » API reference » Contact Storage 8

README.txt in Contact Storage 8 

PROJECT
-------------
https://www.drupal.org/project/contact_storage


INSTALLATION
-------------
1. Download and extract the module to your sites/all/modules/contrib folder.
2. Enable the module on the Drupal Modules page (admin/modules) or using :

   $ drush en

If you want to be able to send messages in HTML format, the Swiftmailer module
is required. To install it, follow the same instructions as above, using the
following module :

https://www.drupal.org/project/swiftmailer

The module administration page is available at : /admin/structure/contact
The module settings page is available at : /admin/structure/contact/settings
Adding a new form can be done at : /admin/structure/contact/add
A listing of sent messages is available at : /admin/structure/contact/messages

INSTRUCTIONS TO ENABLE HTML
-------------
In order to be able to send messages in HTML format, once Swiftmailer module
has been installed and enabled, follow these steps :

1. Enable Mail System and select Swiftmailer as your default mail system.
    In "Configuration" -> "Mail System", choose "Swiftmailer" under "Formatter"
    and "Sender".

2. HTML should not be enforced and provided e-mail format should be respected.
    In "Configuration" -> "Swift Mailer", in the "Messages" tab, select "Plain
    Text" under "Message Format" and check the "Respect provided e-mail
    format." option.

3. Enable sending messages in HTML format within Contact Storage.
    In "Structure" -> "Contact forms", in the "Contact settings" tab, check the
    "Send HTML" option.

4. Customize theming.
    The Contact Storage module provides a default template,
    "swiftmailer--contact.html.twig", in /templates directory. This template
    can be changed to conform to your needs.


OVERVIEW
-------------
Contact Storage module will provide storage for Contact messages which are
fully-fledged entities in Drupal 8. This plus core contact module aim to
provide functionality equivalent to the base-features of Webform or Entity
Form. The goal is to firm up this functionality in contrib with view to move
into core in 8.1.x or later.


FEATURES
-------------
Message storage
Edit messages
Admin listing
Views integration


REQUIREMENTS
-------------
Core Contact Module and Swiftmailer module, if sending messages in HTML format
is desired.


CREDITS
-------------
Collaboration between the following developers :

larowlan
jibran
andypost
berdir

Supporting organizations:
PreviousNext (Development time)
MD Systems (Development time)

File

README.txt
View source 
  1. PROJECT

  2. -------------

  3. https://www.drupal.org/project/contact_storage

  4. 

  5. 

  6. INSTALLATION

  7. -------------

  8. 1. Download and extract the module to your sites/all/modules/contrib folder.

  9. 2. Enable the module on the Drupal Modules page (admin/modules) or using :

  10. 

  11.    $ drush en

  12. 

  13. If you want to be able to send messages in HTML format, the Swiftmailer module

  14. is required. To install it, follow the same instructions as above, using the

  15. following module :

  16. 

  17. https://www.drupal.org/project/swiftmailer

  18. 

  19. The module administration page is available at : /admin/structure/contact

  20. The module settings page is available at : /admin/structure/contact/settings

  21. Adding a new form can be done at : /admin/structure/contact/add

  22. A listing of sent messages is available at : /admin/structure/contact/messages

  23. 

  24. INSTRUCTIONS TO ENABLE HTML

  25. -------------

  26. In order to be able to send messages in HTML format, once Swiftmailer module

  27. has been installed and enabled, follow these steps :

  28. 

  29. 1. Enable Mail System and select Swiftmailer as your default mail system.

  30.     In "Configuration" -> "Mail System", choose "Swiftmailer" under "Formatter"

  31.     and "Sender".

  32. 

  33. 2. HTML should not be enforced and provided e-mail format should be respected.

  34.     In "Configuration" -> "Swift Mailer", in the "Messages" tab, select "Plain

  35.     Text" under "Message Format" and check the "Respect provided e-mail

  36.     format." option.

  37. 

  38. 3. Enable sending messages in HTML format within Contact Storage.

  39.     In "Structure" -> "Contact forms", in the "Contact settings" tab, check the

  40.     "Send HTML" option.

  41. 

  42. 4. Customize theming.

  43.     The Contact Storage module provides a default template,

  44.     "swiftmailer--contact.html.twig", in /templates directory. This template

  45.     can be changed to conform to your needs.

  46. 

  47. 

  48. OVERVIEW

  49. -------------

  50. Contact Storage module will provide storage for Contact messages which are

  51. fully-fledged entities in Drupal 8. This plus core contact module aim to

  52. provide functionality equivalent to the base-features of Webform or Entity

  53. Form. The goal is to firm up this functionality in contrib with view to move

  54. into core in 8.1.x or later.

  55. 

  56. 

  57. FEATURES

  58. -------------

  59. Message storage

  60. Edit messages

  61. Admin listing

  62. Views integration

  63. 

  64. 

  65. REQUIREMENTS

  66. -------------

  67. Core Contact Module and Swiftmailer module, if sending messages in HTML format

  68. is desired.

  69. 

  70. 

  71. CREDITS

  72. -------------

  73. Collaboration between the following developers :

  74. 

  75. larowlan

  76. jibran

  77. andypost

  78. berdir

  79. 

  80. Supporting organizations:

  81. PreviousNext (Development time)

  82. MD Systems (Development time)