You are here

Home » API reference » Simplenews Content Selection 7.2

README.txt in Simplenews Content Selection 7.2

Same filename and directory in other branches
  1. 8 README.txt
  2. 7 README.txt
ABOUT
--------------------------------------------------------------------------------

Simplenews Content Selection allows you to select already created content to
assemble in the body of a newsletter (provided by the Simplenews module)
content type.


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

Enable the module, you'll need to have Simplenews too.


HOW DOES IT WORK
--------------------------------------------------------------------------------

This module provides an action "Create newsletter" in the content administration
form located at admin/content/node.

Check some content in this form, choose the "Create newsletter" action and you
will be provided a sorting form along with the option to create a Table of
Contents.

When validating, you will be redirected to a newsletter creation form with the
body field already filled in.


CONFIGURATION
--------------------------------------------------------------------------------

You can configure the module at admin/config/services/simplenews/settings/scs
you can change the default view mode (which is the one provided vy SCS) used
when generating the output of nodes selected on newsletter creation.

When multiple content types are flagged as newsletter content types, you can
select which content type to generate when using SCS. This is hidden by default
as the "Newsletter" content type is the only one by default.


OVERRIDING OUTPUT
--------------------------------------------------------------------------------

The output generated and placed in the body is built from the view mode set in
the module configuration.

You can override the Drupal way in your theme, for exmplae by specifying a
custom template for this view mode.

If you add this in the template.php file of your theme:

  function YOURTHEME_preprocess_node(&$vars){
    // Add template suggestions based on view modes
    $vars['theme_hook_suggestions'][] = 'node__' . $vars['view_mode'];
    $vars['theme_hook_suggestions'][] = 'node__' . $vars['view_mode'] . '__' . $vars['type'];
  }

You will be able to create a node--scs--article.tpl.php that will be taken into
account after flushing the theme registry and when creating a new newsletter.

You can also override the Table of Contents output by implemeting a function in
your template.php file: function YOURTHEME_scs_toc($variables) {}


VIEWS INTEGRATION
--------------------------------------------------------------------------------

The Simplenews Content Selection Views Integration is a submodule that provides
an action for Views Bulk Operations (VBO), it also provide a default view that
you can enable using Views UI.

If you want to create your own VBO view, add a field "Bulk operation: Content"
and select the action "Create newsletter". Note that the enqueue and skip
confirmation options will have no effect as you will be redirected to
newsletter creation form automatically after sorting.


CONTRIBUTORS
--------------------------------------------------------------------------------

SebCorbin http://drupal.org/user/412171 (current maintainer)

This module was sponsored by Makina Corpus (http://www.makina-corpus.com).

File

README.txt
View source 
  1. 

  2. ABOUT

  3. --------------------------------------------------------------------------------

  4. 

  5. Simplenews Content Selection allows you to select already created content to

  6. assemble in the body of a newsletter (provided by the Simplenews module)

  7. content type.

  8. 

  9. 

  10. INSTALLATION

  11. --------------------------------------------------------------------------------

  12. 

  13. Enable the module, you'll need to have Simplenews too.

  14. 

  15. 

  16. HOW DOES IT WORK

  17. --------------------------------------------------------------------------------

  18. 

  19. This module provides an action "Create newsletter" in the content administration

  20. form located at admin/content/node.

  21. 

  22. Check some content in this form, choose the "Create newsletter" action and you

  23. will be provided a sorting form along with the option to create a Table of

  24. Contents.

  25. 

  26. When validating, you will be redirected to a newsletter creation form with the

  27. body field already filled in.

  28. 

  29. 

  30. CONFIGURATION

  31. --------------------------------------------------------------------------------

  32. 

  33. You can configure the module at admin/config/services/simplenews/settings/scs

  34. you can change the default view mode (which is the one provided vy SCS) used

  35. when generating the output of nodes selected on newsletter creation.

  36. 

  37. When multiple content types are flagged as newsletter content types, you can

  38. select which content type to generate when using SCS. This is hidden by default

  39. as the "Newsletter" content type is the only one by default.

  40. 

  41. 

  42. OVERRIDING OUTPUT

  43. --------------------------------------------------------------------------------

  44. 

  45. The output generated and placed in the body is built from the view mode set in

  46. the module configuration.

  47. 

  48. You can override the Drupal way in your theme, for exmplae by specifying a

  49. custom template for this view mode.

  50. 

  51. If you add this in the template.php file of your theme:

  52. 

  53.   function YOURTHEME_preprocess_node(&$vars){

  54.     // Add template suggestions based on view modes

  55.     $vars['theme_hook_suggestions'][] = 'node__' . $vars['view_mode'];

  56.     $vars['theme_hook_suggestions'][] = 'node__' . $vars['view_mode'] . '__' . $vars['type'];

  57.   }

  58. 

  59. You will be able to create a node--scs--article.tpl.php that will be taken into

  60. account after flushing the theme registry and when creating a new newsletter.

  61. 

  62. You can also override the Table of Contents output by implemeting a function in

  63. your template.php file: function YOURTHEME_scs_toc($variables) {}

  64. 

  65. 

  66. VIEWS INTEGRATION

  67. --------------------------------------------------------------------------------

  68. 

  69. The Simplenews Content Selection Views Integration is a submodule that provides

  70. an action for Views Bulk Operations (VBO), it also provide a default view that

  71. you can enable using Views UI.

  72. 

  73. If you want to create your own VBO view, add a field "Bulk operation: Content"

  74. and select the action "Create newsletter". Note that the enqueue and skip

  75. confirmation options will have no effect as you will be redirected to

  76. newsletter creation form automatically after sorting.

  77. 

  78. 

  79. CONTRIBUTORS

  80. --------------------------------------------------------------------------------

  81. 

  82. SebCorbin http://drupal.org/user/412171 (current maintainer)

  83. 

  84. This module was sponsored by Makina Corpus (http://www.makina-corpus.com).