📊 PPS Impact Module - Entity Structure

Content Types, Paragraphs, and Taxonomies with Field Relationships

Legend

Content Type

Paragraph Type

Taxonomy

Entity Reference

⚠️ Proposed Structure for Tab-based Editing

Current Issue: Using a single paragraph reference field requires complex form alterations to achieve the desired tab layout.

Proposed Solution: Instead of using a single field_issue_homepage_layout paragraph field, we should use separate entity reference fields for each section:

field_featured_articles - Entity reference to Impact Article (4 articles)
field_departments_articles - Entity reference to Impact Article (3 articles)
field_inside_apta - Entity reference to Impact Article (3 articles - Delta 0: Editor's Note, Delta 1: Membership Matters, Delta 2: On the Move)
field_additional_sections - Paragraph reference to additional_sections (unlimited for custom sections)

This approach allows us to:

✅ Easily create tabs in form alter without complex widget manipulation
✅ Use inline_entity_form_simple for direct article creation/selection
✅ Maintain proper field validation and cardinality
✅ Simplify JavaScript progress tracking
✅ Avoid paragraph pre-saving issues

Impact Issue

impact_issue

Content Type

Basic Info Fields

Title Required title

Text

Issue Month field_issue_month

List (select)

Issue Year field_issue_year

List (integer)

Published Date field_published_date

Date

Proposed Article Section Fields

Featured Articles 4 items field_featured_articles

Entity Ref → Article

Departments 3 items field_departments_articles

Entity Ref → Article

Inside APTA 3 items field_inside_apta

Delta 0: Editor's Note
Delta 1: Membership Matters
Delta 2: On the Move

Entity Ref → Article

Additional Sections Unlimited field_additional_sections

Paragraph → additional_sections

Legacy Field (To Be Removed)

Homepage Layout field_issue_homepage_layout

Paragraph → additional_sections

Impact Article

impact_article

Content Type

Article Fields

Title Required title

Text

Summary/Deck field_article_summary

Text (long)

Body field_article_body

Text (formatted)

Author field_article_author

Entity Ref → Authors

Author Bio Override field_article_bio_override

Text (long)

Category field_article_category

Entity Ref → Categories

Keywords Multiple field_article_keywords

Entity Ref → Keywords

Featured Image field_article_image

Image

Published Date field_article_published_date

Date

Sidebar Content field_article_sidebar_content

Text (formatted)

References field_article_references

Text (long)

Impact Archive

impact_archive

Content Type

Archive Fields

Title Required title

Text

Summary Points field_archive_summary

Text (long)

PDF File field_archive_pdf

File

Issue Date field_archive_date

Date

Additional Sections

additional_sections

Paragraph Type

Additional Section Fields

Section Type field_section_type

List (select)

Custom Section Name field_section_custom_name

Text

Section Description field_section_description

Text (long)

Layout Style field_section_layout

List (select)

Articles Multiple field_additional_articles

Entity Ref → Article

Authors

authors

Taxonomy

Author Fields

Name Required name

Text

Title/Position field_author_title

Text

Bio field_author_bio

Text (long)

Photo field_author_photo

Image

Email field_author_email

Article Categories

impact_article_categories

Taxonomy

Category Fields

Name Required name

Text

Description description

Text (long)

Default Categories (Auto-created during module install)

• Practice Management
• Clinical Excellence
• Technology & Innovation
• Business Development
• Regulatory & Compliance
• Patient Engagement
• Staff Development
• Marketing & Outreach
• Finance & Operations
• Leadership

Note: These taxonomy terms will be automatically created during module installation using hook_install() or by including them in config/install/taxonomy.term.impact_article_categories.*.yml files

Keywords

impact_keywords

Taxonomy

Keyword Fields

Name Required name

Text

Description description

Text (long)

🔗 Entity Relationships

Widget Types: IEF = Inline Entity Form (create/edit inline) REF = Entity Reference (select only)

Impact Issue → field_featured_articles → Impact Article IEF (4 featured articles)

Impact Issue → field_departments_articles → Impact Article IEF (3 department articles)

Impact Issue → field_inside_apta → Impact Article IEF (3 articles: Editor's Note, Membership Matters, On the Move)

Impact Issue → field_additional_sections → Additional Sections (Paragraph) IEF (unlimited custom sections)

Impact Article → field_article_author → Authors (Taxonomy) IEF (article author - can create new or select existing)

Impact Article → field_article_category → Categories (Taxonomy) REF (article category - select from predefined list)

Impact Article → field_article_keywords → Keywords (Taxonomy) REF (search keywords - autocomplete tags)

Additional Sections (Paragraph) → field_additional_articles → Impact Article IEF (articles in custom section)

📝 Implementation Notes

Form Tabs: Using separate fields for each section allows clean tab implementation with form_alter
Inline Entity Form: Use inline_entity_form_simple widget for article fields to allow creation/selection inline
Text Format: All formatted text fields should use 'staff_html' format
Field Cardinality: Set proper limits on each field (Featured: 4, Departments: 3, Inside APTA: 3)
Validation: Form validation ensures required number of articles per section
Progress Tracking: JavaScript can easily count articles in each separate field
Custom Sections: Only use paragraphs for unlimited custom sections to maintain flexibility
Author Selection: inline_entity_form automatically handles "select existing or create new" functionality
Bio Override: Articles can override author bio using field_article_bio_override
Article-Issue Relationship: No back-reference needed from Article to Issue. To find which issues contain an article, query Impact Issues that reference it through their article fields. This allows articles to be reused across multiple issues.
Default Category Terms: The 10 default article categories will be automatically created during module installation, either through hook_install() in pps_impact.install or via config/install YAML files for each taxonomy term.