howard/howard_content_types

A comprehensive content type management suite for Howard University Drupal installations, providing structured content types, media management, and seamless integration with the idfive Component Library.

11.0.2 2025-07-07 21:02 UTC

Requires

• php: >=8.1
• drupal/core: ^10 || ^11

Requires (Dev)

• drupal/coder: *
• phpstan/phpstan: ^1.0
• phpunit/phpunit: ^9.0
• squizlabs/php_codesniffer: *

GPL-2.0-or-later

• Howard University Web Team
• Dan Rogers

• Media management
• drupal
• content types
• higher education
• Howard University
• University Website

README

A comprehensive content type management suite for Howard University Drupal installations, providing structured content types, media management, and seamless integration with the idfive Component Library.

Overview

The Howard Content Types module provides a professional content management foundation for Howard University websites. This module suite delivers standardized content types, fields, and configurations that ensure consistency across all university web properties while maintaining flexibility for site-specific customizations.

Key Features

• Structured Content Types: Six specialized content types designed for university content
• Media Integration: Pre-configured entity browsers and media field management
• Component Library Ready: Seamless integration with idfive Component Library
• Flexible Configuration: Override-friendly design for site-specific needs
• Security Focused: Built with university security requirements in mind
• Accessibility Compliant: WCAG 2.1 AA standards compliance

Quick Start

Requirements

• Drupal 9.4+ or Drupal 10.x
• PHP 8.1+
• Composer 2.x

Installation

# Install via Composer
composer require howard/howard_content_types

# Enable the module
drush en howard_content_types -y

# Enable specific sub-modules as needed
drush en hc_article hc_page hc_person -y

Configuration

1. Navigate to Administration > Extend and enable desired sub-modules
2. Configure content types at Administration > Structure > Content types
3. Set up media browsers at Administration > Structure > Entity browsers
4. Review field configurations and customize as needed

Content Types

Available Sub-modules

Module	Content Type	Description
hc_announcements	HC Announcement	University announcements and news updates
hc_article	HC Article	News articles and editorial content
hc_page	HC Basic Page	Standard web pages and landing pages
hc_person	HC Person	Faculty, staff, and student profiles
hc_resource	HC Resource	Educational resources and downloads
hc_standard_homepage	HC Standard Homepage	Structured homepage layouts

Theme Integration

This module provides markup structure without styling. Styles are provided through:

• idfive Component Library
• idfive Component Library D8 Theme

Documentation

Complete Documentation

• 📚 Full Documentation
• ⚙️ Installation Guide
• 🔧 API Reference
• 👨‍💻 Developer Guide
• 📋 Changelog

Quick Links

• Configuration Override Guide
• Theming and Customization
• Security Considerations
• Troubleshooting

Architecture

Design Principles

• Modular Architecture: Each content type is a separate sub-module
• Configuration Management: Site-specific overrides supported
• Security First: Input validation and access controls
• Performance Optimized: Efficient caching and query optimization
• Extensible: Hook system for custom functionality

Integration Points

• Media Management: Entity browsers for consistent media handling
• Field API: Reusable field configurations across content types
• Views Integration: Pre-configured listing and display views
• Search API: Full-text search capabilities
• Workflow: Content moderation and publishing workflows

Contributing

We welcome contributions from the Howard University community and beyond.

Development Setup

# Clone the repository
git clone https://github.com/howard-university/howard_content_types.git

# Set up development environment
composer install
npm install

# Run tests
composer test

Guidelines

• Follow Drupal Coding Standards
• Review our Coding Standards
• Use the Release Checklist for releases
• Submit pull requests with comprehensive tests

Support

Getting Help

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Community Forum
• 📧 Email: [e-mail]

Reporting Issues

Please use our issue tracker and include:

• Drupal version
• Module version
• Steps to reproduce
• Expected vs actual behavior
• Error messages or logs

License

This project is licensed under the GNU General Public License v2.0 or later - see the LICENSE file for details.

Credits

Maintainers

• Howard University Web Team
• idfive Development Team

Contributors

• View all contributors

Acknowledgments

• Howard University IT Services
• Drupal Community
• idfive Component Library Team

Howard University | Building Excellence in Web Content Management