⚰️ HumanKind Funeral Suite 🎩💐

A powerful WordPress plugin to streamline funeral home websites adding custom post types, taxonomies and fields for Staff, Caskets, Urns, Monuments and Pricing Packages, along with specialised Gutenberg blocks for easy content management. Basic meta fields are included, no need for ACF.

📝 Description

HumanKind Funeral Suite transforms WordPress sites for funeral homes, allowing them to manage essential services with ease. This plugin introduces specialised custom post types for:

• Team Members & Staff – Manage funeral home staff for the website, their roles, contact and multiple locations
• Caskets – Showcase available caskets and pricing in an organised catalog
• Urns – Display urn options and pricing for families to choose from
• Monuments – Display monument & Headstone options and pricing for families to choose from
• Keepsakes – Display keepsake options and pricing
• Pricing Packages – Present funeral service packages with clear pricing

Each content type comes with tailor-made fields and taxonomies to fit the needs of the funeral industry.

✨ Features

• Team Management – Add and manage staff profiles with location & roles
• Product Catalogs – Create searchable listings for caskets, urns, monuments, keepsakes and headstones
• Pricing Packages – Display service packages with clear pricing
• Feature Flexibility – Enable or disable specific features as needed

---

• Gutenberg Blocks for Post Entry:

  • Team Member block with metadata fields for qualifications, position, contact info, and taxonomies
  • Casket, Urn, Monument & Keepsake blocks with price and category fields
  • Pricing Package block with price and order fields

• Admin Features:

  • Customisable settings page to enable/disable individual CPTs
  • User roles and custom capabilities for role-based access control
  • Automatic updates from GitHub repository

• Developer Features:

  • Import compatibility with All Import Pro
  • REST API integration for programmatic content creation
  • Block template locking for consistent data entry
  • Shortcodes for displaying custom fields and pricing in templates

📈 Google Sheet Sync for Pricing

The HumanKind Funeral Suite now includes a one way sync with Google Sheets for urn, casket and pricing package pricing management. This was requested by a client who wanted their Manager/Finance team to be able to quickly adjust pricing without logging into the website. Also be able to see from a spreadsheet what all the price plans were.

Once setup via a Google Apps Script this allows you to:

• Manage pricing for packages, caskets, and urns from a central Google Sheet
• Automatically sync updates to your WordPress site
• Prevent accidental price edits in the WordPress admin that would be overwritten

Features

• Admin Integration: Clear visual indicators show when pricing is managed externally
• Content Protection: Price fields are automatically disabled when Google Sheets integration is active
• Flexible Control: Enable/disable integration independently for each product type
• Cache Management: Automatic cache clearing ensures pricing updates appear immediately

Configuration

1. Navigate to Settings → HK Funeral Suite
2. In the "Internal Use / Developer Options" section, find the Google Sheets Data Sync options
3. Enable Google Sheets integration for your desired product types
4. Contact Weave Digital Studio for help setting up the Google Sheet connection

Developer Notes

When Google Sheets integration is enabled, the plugin adds hooks to:

• Prevent pricing fields from being edited in WordPress
• Display visual indicators in the admin interface
• Support the REST API for external updates
• Clear caches automatically when prices are updatet. Tested for Internal use and used with the Weave Cache Purge Helper.

🍰 Shortcodes

[hk_formatted_price]

Outputs a formatted price from a custom field with proper currency formatting.

Key features:

• Currency symbol customisation
• Prefix and suffix support
• Adjustable decimal precision
• Graceful fallback for non-numeric values (e.g., "P.O.A.")

[hk_custom_field]

Displays any custom field value with optional formatting and fallbacks.

Key features:

• Date formatting support
• Before/after content wrappers
• Fallback content for empty fields
• Option for raw output without wrappers
• HTML tag stripping option

More info see Shortcode Usage Examples

---

📥 Plugin Installation

📌 Manual Installation

1. Download the latest .zip file from the Releases Page.
2. Go to Plugins > Add New > Upload Plugin.
3. Upload the zip file, install, and activate!

📌 From GitHub (For Developers)

git clone https://github.com/HumanKind-nz/hk-funeral-suite.git
cd hk-funeral-suite
composer install  # (if Composer is used)

💡 Then zip the directory contents and upload it via WordPress admin or copy it to the wp-content/plugins/ directory manually.

🔄 Auto-Updater via GitHub

This plugin supports automatic updates directly from GitHub using a custom updater. To ensure updates work:

1. Keep the plugin installed in wp-content/plugins/hk-funeral-suite.
2. When a new release is available, the WordPress updater will notify you.
3. Click Update Now in the Plugins page to install the latest version.

---

Requirements

• WordPress 5.8 or higher
• PHP 7.4 or higher
• A funeral website

[!IMPORTANT] Block Editor Requirement: This plugin relies on the WordPress block editor (Gutenberg) to manage block meta entries for the custom post types (CPTs). If the block editor is disabled (for example, if the Disable Gutenberg plugin is active), the CPTs may not function as intended. Please ensure that Gutenberg is enabled for full plugin functionality.

🚀 Usage

🎯 Getting Started

1. After activation, visit the "HK Funeral Suite Settings" menu in WordPress Admin.
2. Use the Settings page to enable or disable specific features.
3. Start adding your content under the newly created post types.

Adding Staff Members

1. Navigate to "Staff" in the admin menu
2. Click "Add New"
3. Enter the staff member's name as the title
4. Add a featured image for the staff photo
5. Use the Team Member block to enter position, qualifications, contact details, etc.
6. Assign staff to locations and roles using the provided taxonomies
7. Publish when ready

Managing Caskets, Urns, Monuments or Keepsakes

1. Navigate to "Caskets", "Urns", "Monuments" or "Keepsakes" in the admin menu
2. Click "Add New"
3. Enter the product name as the title
4. Add a featured image
5. Use the corresponding block to enter pricing and select a category
6. Add description and other content as needed
7. Publish when ready

Creating Pricing Packages

1. Navigate to "Packages" in the admin menu
2. Click "Add New"
3. Enter the package name as the title
4. Use the Pricing Package block to enter an intro, price and display order
5. Add description and details of what's included in the package
6. Publish when ready

🚀 🦫 When using with Beaver Themer

• 🦫 Meta Fields & Beaver Builder Integration - Guide for leveraging custom meta fields in Beaver Themer layouts

⬆️ Importing Post Content

The plugin is compatible with WP All Import Pro for bulk importing content. When importing:

1. Set up your import as usual, mapping fields to the appropriate columns
2. The plugin should automatically add the required blocks to imported posts
3. After import, review and update any missing metadata as needed

Developers - UI Optimisation for Popular Themes/Plugins

Streamline the editing interface by removing unnecessary meta boxes

• Support for cleaning up UI elements individually in the "Developer Options" section of settings page
• GeneratePress - removes layout options and sections meta boxes
• Page Builder Framework - removes theme settings meta boxes
• Happy Files - Removed Featured image column as not required
• SEO Press - Removed extra un-needed Metaboxes and Content Analysis metaboxes Note: This is an opinionated list of themes and plugins we use at Weave Digital Studio and HumanKind Funeral websites, but can be extended for other tools

---

📂 Plugin Structure

🗂️ This plugin is designed for modularity and ease of maintenance:

hk-funeral-suite/
├── includes/
│   ├── admin/
│   │   ├── class-settings-page.php     # Plugin settings management
│   │   ├── class-capabilities.php      # Custom capabilities for CPTs
│   │   ├── class-github-updater.php    # GitHub automatic updates
│   │   ├── class-block-editor.php      # Custom block defaults for CPTs
│   │   ├── class-post-mods.php         # Post modifications/customizations
│   │   ├── class-admin.php             # Admin-specific functionality
│   │   ├── class-hk-funeral-cpt-admin-columns.php  # Adjust admin columns, remove SEO columns
│   │   └── class-hk-funeral-cpt-compatibility.php  # Add theme/plugin compatibility optimisations
│   ├── blocks/
│   │   ├── assets/                     # Shared block assets
│   │   │   └── block-editor-styles.css # Block editor specific styles
│   │   ├── team-member-block/
│   │   │   ├── init.php                # Team member block registration
│   │   │   └── index.js                # Team member block script
│   │   ├── casket-block/
│   │   │   ├── init.php                # Casket block registration
│   │   │   └── index.js                # Casket block script
│   │   ├── urn-block/
│   │   │   ├── init.php                # Urn block registration
│   │   │   └── index.js                # Urn block script
│   │   ├── pricing-package-block/
│   │   │   ├── init.php                # Pricing package block registration
│   │   │   └── index.js                # Pricing package block script
|   |   ├── monument-block/
│   │   │   ├── init.php                # Monument block registration
│   │   │   └── index.js                # Monument block script
|   |   ├── keepsake-block/
│   │   │   ├── init.php                # Keepsake block registration
│   │   │   └── index.js                # Keepsake block script
│   │   └── block-styles.php            # Shared block styling
│   ├── cpt/
│   │   ├── class-product-cpt-factory.php   # Factory for product-type CPTs
│   │   ├── cpt-registration.php            # Dynamic CPT registration system
│   │   ├── cpt-shared-functions.php        # Shared functions across all CPTs
│   │   ├── staff.php                       # Staff CPT registration
│   │   ├── packages.php                    # Packages CPT registration
│   │   └── keepsakes.php                   # Keepsakes CPT registration
│   ├── import/
│   │   └── class-default-blocks-importer.php  # Import integration
│   └── class-shortcodes.php            # Shortcode registration ([hk_formatted_price], [hk_custom_field])
├── assets/
│   └── images/                        # Main plugin images
│       └── hk-funeral-suite-banner.png                     
│       └── icon-256x256.png                    
├── README.md                          # Main documentation
├── CHANGELOG.md                       # Version history
├── beaver-themer-guide.md            # Beaver Themer integration guide
├── shortcode-usage.md                # Shortcode usage examples
├── LICENSE                           # License file
└── hk-funeral-suite.php              # Main plugin file

🔄 Changelog

Full Changelog Here

1.4.7 - 2024-04-22

• Added new [hk_custom_field] shortcode for reliable custom field display in Page Builders, including examples.
• Changed default for [hk_formatted_price] shortcode to show 0 decimal places (use decimals="2" to display cents)

1.4.6 - 2024-04-18 - Keepsakes

• Added Support for the Keepsakes CPT in the Block Editor
• Added Core button blocks (core/button and core/buttons) to all CPTs
• Fixed issue with slow post saving due to inefficient cache purging. Overall NGINX page cache improvements
• Fixed duplicate code in pricing package block save handler

[1.4.5] - 2025-04-09

• Added decimals="0" parameter to shortcodes in the package admin column

[1.4.4] - 2025-04-09

• Added Shortcode added to the pricing packages admin for easier content embedding
• Fixed useEffect hook issues in Gutenberg blocks to properly sync metadata
• Fixed Google Sheets integration edge cases in price management system

[1.4.1] - 2025-04-08

• Added Enhanced cache clearing for REST API meta updates
• Improved Compatibility with external data sources and page builders

[1.4.0] - 2025-04-07

• Added Keepsakes custom post type for showcasing memorial keepsakes
• Added Custom meta fields for keepsakes including product code, metal type, and stones
• Added Keepsake block with specialised fields for easy content management
• Improved REST API support for keepsake meta fields

[1.3.0] - 2025-03-23

• Added Monuments custom post type for showcasing monuments and headstones
• Added Moved to shared CPT registration code for simplicity and easier extra CPTs
• Added Custom user roles for Funeral Staff and Funeral Manager for permissions and management
• Improved Centralised product registration with hooks for plugin extensibility

[1.2.4] - 2025-03-15

• Added Support for hiding SEOPress metaboxes on CPTs and UI cleanup