diff --git a/modules/paragraphs_demo/paragraphs_demo.module b/modules/paragraphs_demo/paragraphs_demo.module index 1a814ee..b7b65a5 100644 --- a/modules/paragraphs_demo/paragraphs_demo.module +++ b/modules/paragraphs_demo/paragraphs_demo.module @@ -5,6 +5,29 @@ * Contains paragraphs_demo.module */ +use Drupal\Core\Url; +use Drupal\Core\Routing\RouteMatchInterface; + +/** + * Provides a help text for the Paragraphs demo module. + */ +function paragraphs_demo_help($route_name, RouteMatchInterface $route_match) { + switch ($route_name) { + // Help for the paragraphs demo module. + case 'help.page.paragraphs_demo': + $output = ''; + $output .= '

' . t('About') . '

'; + $output .= '

' . t('The Paragraphs Demo module provides several paragraphs types for the Paragraphs module, but no separate user interface. For more information, see the online documentation for the Paragraphs module.', [':online' => 'https://www.drupal.org/node/2444881', ':paragraphs' => Url::fromRoute('help.page', ['name' => 'paragraphs'])->toString()]) . '

'; + $output .= '

' . t('Uses') . '

'; + $output .= '
' . t('Changing demo paragraphs types') . '
'; + $output .= '
' . t('Administrators can edit the provide paragraphs types on the Paragraphs types page if the Field UI module is enabled. For more information on fields and entities, see the Field module help page.', [':paragraphs' => Url::fromRoute('entity.paragraphs_type.collection')->toString(), ':field' => Url::fromRoute('help.page', ['name' => 'field'])->toString(), ':field_ui' => (\Drupal::moduleHandler()->moduleExists('field_ui')) ? Url::fromRoute('help.page', ['name' => 'field_ui'])->toString() : '#']) . '
'; + $output .= '
' . t('Deleting demo paragraphs types') . '
'; + $output .= '
' . t('The provided demo paragraph types stay available even when the Paragraphs Demo module is uninstalled. They can be deleted individually on the Paragraphs types page.', [':paragraphs' => Url::fromRoute('entity.paragraphs_type.collection')->toString()]) . '
'; + return $output; + break; + } +} + /** * Implements hook_preprocess_node() for paragraph node templates. * diff --git a/modules/paragraphs_type_permissions/paragraphs_type_permissions.module b/modules/paragraphs_type_permissions/paragraphs_type_permissions.module index cb410f9..fe6a191 100644 --- a/modules/paragraphs_type_permissions/paragraphs_type_permissions.module +++ b/modules/paragraphs_type_permissions/paragraphs_type_permissions.module @@ -4,9 +4,31 @@ * Add view / create / update / delete permissions for all paragraph types. */ +use Drupal\Core\Url; use Drupal\Core\Access\AccessResult; use Drupal\Core\Session\AccountInterface; use Drupal\paragraphs\ParagraphInterface; +use Drupal\Core\Routing\RouteMatchInterface; + +/** + * Provides a help text for the Paragraphs Type Permissions module. + */ +function paragraphs_type_permissions_help($route_name, RouteMatchInterface $route_match) { + switch ($route_name) { + // Help for the paragraphs type permissions module. + case 'help.page.paragraphs_type_permissions': + $output = ''; + $output .= '

' . t('About') . '

'; + $output .= '

' . t('The Paragraphs Type permission module allows administrators to configure permission individually for each paragraphs type. For more information, see the online documentation for the Paragraphs module.', [':online' => 'https://www.drupal.org/node/2444881']) . '

'; + $output .= '

' . t('Uses') . '

'; + $output .= '
' . t('Configuring permissions per paragraphs type') . '
'; + $output .= '
' . t('Administrators can configure the permissions to view, create, edit and delete each paragraphs type individually on the Permissions page.', [':permissions' => Url::fromRoute('user.admin_permissions')->toString()]) . '
'; + return $output; + break; + } +} + + /** * Implements hook_ENTITY_TYPE_access() for entity type "paragraph". diff --git a/paragraphs.module b/paragraphs.module index 18d87a5..c429a19 100644 --- a/paragraphs.module +++ b/paragraphs.module @@ -5,6 +5,7 @@ * Contains paragraphs.module */ +use Drupal\Core\Url; use Drupal\Core\Routing\RouteMatchInterface; use Drupal\paragraphs\Entity\ParagraphsType; use Drupal\Core\Render\Element; @@ -18,15 +19,22 @@ /** * Implements hook_help(). */ - -function paragraphs_help($route_name, RouteMatchInterface $route_match) -{ +function paragraphs_help($route_name, RouteMatchInterface $route_match) { switch ($route_name) { // Main module help for the paragraphs module. case 'help.page.paragraphs': $output = ''; $output .= '

' . t('About') . '

'; - $output .= '

' . t('Paragraphs') . '

'; + $output .= '

' . t('The Paragraphs module provides a field type that can contain several other fields and thereby allows users to break content up on a page. Administrators can predefine paragraphs types (for example a simple text block, a video, or a complex and configurable slideshow). Users can then place them on a page in any order instead of using a text editor to add and configure such elements. For more information, see the online documentation for the Paragraphs module.', [':online' => 'https://www.drupal.org/node/2444881']) . '

'; + $output .= '

' . t('Uses') . '

'; + $output .= '
' . t('Creating paragraphs types') . '
'; + $output .= '
' . t('Paragraphs types can be created by clicking Add paragraphs type on the Paragraphs types page. By default a new paragraphs type does not contain any fields.', [':paragraphs' => Url::fromRoute('entity.paragraphs_type.collection')->toString()]) . '
'; + $output .= '
' . t('Configuring paragraphs types') . '
'; + $output .= '
' . t('Administrators can add fields to a paragraphs type on the Paragraphs types page if the Field UI module is enabled. The form display and the display of the paragraphs type can also be managed on this page. For more information on fields and entities, see the Field module help page.', [':paragraphs' => Url::fromRoute('entity.paragraphs_type.collection')->toString(), ':field' => Url::fromRoute('help.page', ['name' => 'field'])->toString(), ':field_ui' => (\Drupal::moduleHandler()->moduleExists('field_ui')) ? Url::fromRoute('help.page', ['name' => 'field_ui'])->toString() : '#']) . '
'; + $output .= '
' . t('Creating content with paragraphs') . '
'; + $output .= '
' . t('Administrators can add a paragraph field to content types or other entities, and configure which paragraphs types to include. When users create content, they can then add one or more paragraphs by choosing the appropriate type from the dropdown list. Users can also reorder these paragraphs. This allows users to add structure to a page or other content (for example by adding an image, a user reference, or a differently formatted block of text) more easily then including it all in one text field or by using fields in a pre-defined order.') . '
'; + $output .= '
' . t('Preparing to uninstalling paragraphs') . '
'; + $output .= '
' . t('The Paragraphs module cannot be uninstalled when there is Paragraphs data on your website. Users with the appropriate permissions can delete all relevant data by clicking Delete Paragraphs data on the Prepare uninstall page.', [':uninstall' => Url::fromRoute('paragraphs.prepare_uninstall')->toString()]) . '
'; return $output; break; }