Church Directory for CAR

Version: 1.0.0
Author: Bo Kelleher
License: MIT
Description: Display church directory with photo grids, team members, and committees. Extends Church Attendance Reports plugin.

---

📦 Overview

Church Directory for CAR is an extension plugin that adds comprehensive directory functionality to the Church Attendance Reports ecosystem. Display team members, staff, committees, and ministries with beautiful photo grids and detailed member profiles.

---

✨ Features

✅ Team Member Management

• Custom post type for team members
• Photo grid displays with priority ordering
• Committee/Ministry taxonomy organization
• Detailed member profiles with custom fields
• Responsive grid layouts

✅ Display Options

• Photo grid shortcode with filtering
• Single member template
• Committee-based filtering
• Priority-based ordering
• Mobile-responsive design

✅ Custom Fields (ACF Integration)

• Display Priority (for ordering)
• Phone number
• Email address
• Position/Title
• Committee assignments
• Member photos

✅ Styling

• Brand-aligned styles
• Elementor compatibility
• Mobile-optimized layouts
• Customizable CSS

---

📋 Requirements

• WordPress: 5.0 or higher
• PHP: 7.4 or higher
• Required Plugin: Church Attendance Reports v1.1.0+
• Recommended: Advanced Custom Fields (ACF) Pro for custom fields

---

🔧 Installation

Method 1: WordPress Admin

1. Download the latest release ZIP file
2. Go to Plugins → Add New in WordPress admin
3. Click Upload Plugin and choose the ZIP file
4. Click Install Now and then Activate

Method 2: Manual Installation

1. Download and extract the plugin files
2. Upload the car-directory folder to /wp-content/plugins/
3. Activate the plugin through the 'Plugins' menu in WordPress

Method 3: Git Clone

cd /path/to/wp-content/plugins/
git clone https://github.com/bokelleher/car-directory.git

Then activate in WordPress admin.

---

🚀 Usage

Creating Team Members

1. Go to Team Members → Add New in WordPress admin
2. Enter member name, bio, and details
3. Set featured image (member photo)
4. Assign to committees/ministries
5. Fill in custom fields (phone, email, position, priority)
6. Publish

Displaying the Directory

Use the provided shortcode in any page or post:

[etndi_directory]

Shortcode Parameters:

// Display all members
[etndi_directory]

// Filter by committee
[etndi_directory committee="leadership"]

// Limit number of members shown
[etndi_directory limit="12"]

// Combine parameters
[etndi_directory committee="staff" limit="8"]

Single Member Pages

Each team member gets their own page automatically at:

yoursite.com/team-member/member-name/

---

🎨 Styling

Included CSS Files

The plugin includes several CSS files for different purposes:

1. etndi-brand-aligned-styles.css - Main directory styles
2. elementor-compatibility.css - Ensures compatibility with Elementor
3. mobile-overlap-fixes.css - Mobile responsiveness fixes

Customizing Styles

To override styles, add CSS to your theme's stylesheet or use Appearance → Customize → Additional CSS:

/* Example: Change grid columns */
.etndi-directory-grid {
    grid-template-columns: repeat(4, 1fr);
}

/* Example: Adjust member card styling */
.etndi-member-card {
    border-radius: 10px;
    box-shadow: 0 4px 6px rgba(0,0,0,0.1);
}

---

🔌 Integration with CAR Ecosystem

Works With:

• Church Attendance Reports - Core plugin (required)
• Church Team Widget for CAR - Elementor widgets

Shared Features:

• Uses CAR's role system for permissions
• Integrates with CAR's church taxonomy
• Follows CAR's design patterns

---

📁 File Structure

car-directory/
│
├── car-directory.php              # Main plugin file
├── single-team-member.php         # Single member template
├── etndi-brand-aligned-styles.css # Main styles
├── elementor-compatibility.css    # Elementor fixes
├── mobile-overlap-fixes.css       # Mobile responsiveness
├── README.md                      # This file
├── CHANGELOG.md                   # Version history
└── LICENSE                        # MIT License

---

🛠️ Development

Function Reference

Register CPT:

etndi_register_team_member_cpt()

Register Taxonomy:

etndi_register_committee_taxonomy()

Register ACF Fields:

etndi_register_acf_fields()

Directory Shortcode:

etndi_directory_shortcode($atts)

---

🐛 Known Issues

• ACF fields require ACF Pro to be installed
• Requires Church Attendance Reports to be active

---

📝 Changelog

See CHANGELOG.md for detailed version history.

---

🤝 Contributing

Contributions are welcome! To contribute:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Copyright (c) 2025 Bo Kelleher

---

👤 Author

Bo Kelleher

• GitHub: @bokelleher

---

🔗 Related Projects

• Church Attendance Reports - Core attendance tracking plugin
• Church Team Widget for CAR - Elementor team widgets

---

📞 Support

For support, please:

1. Check existing issues
2. Create a new issue if needed
3. Review the main CAR documentation

---

🙏 Acknowledgments

• Built as an extension for Church Attendance Reports
• Designed for church directory management
• Inspired by community needs in church administration