Setup for WordPress - Classic Editor + ACF Pro

Tips

This section is also applicable to ClassicPress usage. You will still need ACF Pro, but you don't need the Classic Editor plugin.

Prerequisites

Composer installed on your machine
WordPress site installed and running locally
Classic Editor plugin installed and active on your local site
Advanced Custom Fields Pro installed and active on your local site.

Package details

Comet Components for ACF Flexible Content plugin Essential

The Comet Components for ACF Flexible content plugin provides modules that correspond to selected Comet components, so you can use the ACF "fill in a form" interface to add and configure components in the classic editing experience.

Comet Canvas Classic theme Essential

The Comet Canvas theme is designed to be used as a parent theme and provides:

Common navigation menu configuration
Implementations of Comet's SiteHeader and SiteFooter components (with relevant inner components like
Menu) in the relevant files as per the WordPress template hierarchy
Enqueueing of theme style.css files for itself and child themes in the block editor and front-end
Extendable classes for configuration and functionality that can be overridden in child themes
Site Health checks for required and recommended plugins.

Installation

The easiest way to install the Comet Components for ACF plugin, the Comet Classic Canvas theme, and their dependencies is to use Composer with the below
composer.json configuration.

Add this file in your project root (the same level as the wp-content directory), or update your existing composer.json if you have one:

{
    "name": "your-project-name",
    "description": "Custom WordPress site",
    "type": "project",
    "private": true,
    "minimum-stability": "dev",
    "prefer-stable": true,
    "require": {
 	   "php": "^8.3",
 	   "doubleedesign/comet-plugin-acf": "dev-master",
 	   "doubleedesign/comet-canvas-classic": "dev-master",
 	   "composer/installers": "^2.0",
 	   "doubleedesign/doublee-base-plugin": "dev-master",
 	   "doubleedesign/doublee-breadcrumbs": "dev-main",
        "doubleedesign/doublee-tinymce": "dev-main",
        "doubleedesign/acf-advanced-image-field": "dev-main"
    },
    "config": {
 	   "allow-plugins": {
 		   "composer/installers": true
 	   },
 	   "preferred-install": {
 		   "doubleedesign/comet-components-core": "dist"
 	   }
    },
    "repositories": [
 	   {
 		   "type": "vcs",
 		   "url": "https://github.com/doubleedesign/baguetteBox.js"
 	   }
    ],
    "extra": {
 	   "installer-paths": {
 		   "wp-content/plugins/{$name}/": [
 			   "type:wordpress-plugin",
 			   "doubleedesign/comet-plugin-acf",				
 			   "doubleedesign/doublee-base-plugin",
 			   "doubleedesign/doublee-breadcrumbs",
				   "doubleedesign/doublee-tinymce",
                "doubleedesign/acf-advanced-image-field"
 		   ],
 		   "wp-content/themes/{$name}/": [
 			   "type:wordpress-theme",
 			   "doubleedesign/comet-canvas-classic"
 		   ]
 	   },
 	   "resolve-dependencies": false
    }
}

To install the plugins and theme, run the following command in your terminal:
```
composer install
```
Or if you're updating an existing installation:
```
composer update
```
It is then recommended to cd into each directory and ensure the autoloaders are up to date:
```
composer dump-autoload -o
```
The theme and plugin are configured to look for the core library and its dependencies in the main (comet-plugin-acf) plugin's
vendor directory. If you have any issues with dependencies, cd into the comet-plugin-acf directory and run:
```
composer update
```
```
composer dump-autoload -o
```

What's included

The above Composer configuration installs the below:

Comet essentials

Other plugins

Double-E Breadcrumbs plugin - the Comet themes and plugins are configured to work with this for breadcrumbs in the PageHeader component.
Double-E Design Base Plugin - provides site "Global Options", some admin customisations, user role customisations, and other features and customisations commonly used for Double-E Design websites.
Double-E TinyMCE - provides customised configurations and plugins for TinyMCE fields and the Classic Editor. Plugins include the ability to add a button group, callout, pullquote, or table to TinyMCE-driven content fields. Highly recommended for the as-intended content editing experience.
Add-ons such as Comet Calendar have not yet been updated to support the Classic setup.
Advanced Image Field for ACF by Double-E Design - Comet's flexible content modules are designed to utilise this plugin for enhanced image field functionality, including aspect ratio and focal point cropping options.

Troubleshooting

Latest version not installing

Delete the folder of the plugin or theme you are trying to update
Run composer clear-cache
Run composer update --prefer-source
:::