PARAGRAPH USAGE DASHBOARD MODULE
================================

REQUIREMENTS
------------

This module requires the following:

* Drupal Core 11.x
* Paragraphs module (https://www.drupal.org/project/paragraphs)
* PHP 8.1 or higher


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

Install the Paragraph Usage Dashboard module as you would normally install a
contributed Drupal module. Visit https://www.drupal.org/node/1897420 for
further information.

Using Composer (recommended):

  composer require drupal/paragraph_usage_dashboard

Using Drush:

  drush en paragraph_usage_dashboard

Using the UI:

  1. Place the module in your modules directory (e.g., /modules/contrib)
  2. Navigate to Administration > Extend
  3. Enable "Paragraph Usage Dashboard"


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

1. Grant the "Access paragraph usage dashboard" permission to appropriate roles
   at Administration > People > Permissions

2. Navigate to Administration > Reports > Paragraph Usage to access the
   dashboard

3. (Optional) Use the filter form to select specific paragraph types to display


USAGE
-----

Main Dashboard:
  Visit /admin/reports/paragraph-usage to view the dashboard showing:
  - Paragraph type icons
  - Content types using each paragraph
  - Path aliases of parent entities
  - Quick view links

Filter Paragraph Types:
  Use the filter form at the top of the dashboard to select which paragraph
  types to display. Your selection will persist across sessions.

Detail View:
  Click on any paragraph type name to see detailed information about every
  instance where that paragraph type is used, including:
  - Entity title
  - Content type
  - Field name
  - Path alias
  - View link


TROUBLESHOOTING
---------------

If the dashboard is empty:
  - Ensure you have paragraph types created
  - Verify that content exists using those paragraph types
  - Check that the paragraphs module is enabled
  - Clear Drupal's cache

If icons don't display:
  - Verify that icons are configured in your paragraph type settings
  - Check file permissions for the icon files
  - Ensure the file entity exists in the system

For access issues:
  - Verify the user has the "Access paragraph usage dashboard" permission
  - Check that the user can view the content that uses the paragraphs


SUPPORT
-------

For bug reports and feature requests:
  https://www.drupal.org/project/issues/paragraph_usage_dashboard

For documentation:
  See README.md in the module directory


MAINTAINERS
-----------

Current maintainers:
 * See the project page for current maintainers:
   https://www.drupal.org/project/paragraph_usage_dashboard
