Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/jamiewilliamsxyz/catholic-parish-core/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
This project is a companion WordPress plugin built to provide the core features for the Catholic Parish theme. Separating certain features follows WordPress best practises, ensures content portability and stops data loss if the user decides to switch to another theme.
⚠️ Designed to work with the Catholic Parish WordPress Theme - The theme README has a demo site, more images and covers the entire project in depth, both theme and plugin
🧰 Tech Stack
📌 Purpose
- Provides structured CPTs and taxonomies for Catholic parish needs
- Allows portability of content and reduces dependency of a single theme
- Follows best security practices when handling user input, nonce verification and with capability checks
🚀 Features
Custom Post Types
- Announcement
- Service
- Newsletter
- Parish Staff
- Church Group Each comes with its own custom Meta Boxes
Custom Taxonomies
- Parish Staff Type
- Church Group Type
Shortcodes
[parish_phone][parish_email][parish_church_address][parish_office_address][parish_office_hours][parish_details]
Hook & APIs Used
- Action hook for admin notice when the theme is missing
- Filter hook to replace "Add CPT" placeholder text
- WordPress Settings and Options APIs for Parish Details settings page
Security Practices
- Input sanitisation and output escaping
- Capability checks
- Nonce verification for handling contact form submissions
Installation
- Download this repository
- Rename the folder to
catholic-parish-core - Upload to WordPress plugins
- Activate the plugin via WordPress
🖼️ Screenshots
Add Parish Staff - Custom Post Type Admin UI
Parish Details - Custom Settings Page
