README.txt in Paragraphs Sets 8.2

-- SUMMARY --

The "Paragraphs Sets" module allows to create sets of paragraphs added to an
entity by default or selected while creating the entity.


-- REQUIREMENTS --

Obviously you'll need to install the "Paragraphs" module.


-- INSTALLATION --

Install as usual, see
https://www.drupal.org/documentation/install/modules-themes/modules-8 for
further information.


-- WIDGET SETTINGS --

"Paragraphs Sets" exposes settings on the "Paragraphs EXPERIMENTAL" widget.

  * "Enable Paragraphs Sets": Whether to show the Paragraphs Sets form element
    at the top of the Paragraphs widget.
  * "Limit sets to": Restrict the sets available in the Paragraphs Sets form
    element.
  * "Default set": Use this Paragraphs Sets set as the "default value" for the
    widget. Note that the "Default paragraph type" must be set to "- None -"
    for this to work.


-- CONFIGURATION EXAMPLES --

There is no UI (yet?) for creating paragraph sets so you have to create the
config entities manually. Setting default values is limited (and tested only)
for primitive field types. Setting complex field values requires implementing
hook_paragraphs_set_data_alter(). See paragraphs_sets.api.php for all hooks.

  * Create a set containing a single paragraph of type "text":
    
    id: ps_example_text
    label: 'Simple text (empty)'
    description: 'Simple text paragraph without values'
    paragraphs:
      -
        type: text
        data: {  }
    
  * Create a set containing multiple paragraphs with default values:
    
    id: ps_example_text_multiple
    label: 'Multiple paragraphs'
    description: 'Multiple paragraphs with default values'
    paragraphs:
      -
        type: text
        data:
          field_headline: 'First item'
          field_content: '
You may add HTML, too!
'
      -
        type: text_with_image
        data:
          field_headline: 'Second item'
      -
        type: text
        data:
          field_content: '
This is another text paragraph.
'
    


-- CONTACT --

Current maintainers:
* Stefan Borchert (stborchert) - http://drupal.org/user/36942

This project has been sponsored by:

  * undpaul
    Drupal experts providing professional Drupal development services.
    Visit http://www.undpaul.de for more information.