/padstone

Padstone is a Craft CMS starter that includes plugins and configuration Imarc has found to be useful defaults.

Primary LanguageJavaScriptOtherNOASSERTION

Padstone

Padstone is a start for using Craft CMS that works with composer create-project and composer/installers to streamline initial site creation.

What's Included

Padstone includes the following:

Sections

  • Meta Fields - a common Meta Description and Title tag override field are included.
  • Blog Section - this channel section is built out with Title, Description, Content, and the above meta fields.
  • Pages Section - this structure section is built out with a the meta fields above, as well as a Structured Content matrix field that supports the following block types:
    • Full Width
    • Two Columns
    • Three Columns
    • Video with Text
    • Image with Text
    • Testimonial
  • Team Section - this structure section is built out with fields for Name, Photo, and Bio.

Plugins

The following plugins are currently included and installed via composer/installers and are referenced in the composer.json file.

Macros

There is a _macros.twig file that (so far) just provides a macro for generating pagination.

Usage

Start out with Padstone by running the following composer command in a terminal:

composer create-project imarc/padstone [folder]

This command downloads Padstone, Craft, and some hand-selected Craft plugins, and puts everything in the right place.

At this point, you'll need to Create your database as you would a normal Craft install.

Next, you should edit both .env and craft/config/db.php to match your site. At the minimum, you should add the site domain, database info, and remove any unused fields from .env and the db.php file. If using multiple environments, copy the .env to each environment and update to match that environment's database, domain, etc.

Now, you can run the installer by going to http://example.com/admin (except for your domain.)

Lastly, in a terminal on the server in your new folder, run

vendor/bin/schematic import

This imports the schema.yml file, creating fields, enabling the plugins, etc.

At this point, you're done. Feel free to delete the Craft ZIP, The padstone/ directory, or the craft/config/schema.yml file.

Local Usage

Start local environment with Docker:

docker-compose up -d

One first run, install craft and schema and initial admin user:

docker exec -i $(docker-compose ps -q craft) bash scripts/install.sh

Shut down local environment:

docker-compose stop

Destroy local environment:

# CAUTION! This will destroy all data volumes, such as the database and uploads!
# DO NOT RUN THIS UNLESS YOU ARE SURE ALL PERSISTANT DATA CAN BE DELETED
docker-compose down -v

Changelog

1.4.0

1.3.0

  • Added Retour, replacing Reroute for handling redirects. Retour provides more features, allows for regex in redirects, and provides a statistics widget for the dashboard.
  • Removed Reroute
  • Added Field Manager.
  • Added Tag Manager, primarily because stock Craft doesn't seem to provide a away to delete tags.

1.2.0

  • Added craft-kindling, and swapped out the templates included in the ZIP for some provided by Padstone.

1.1.0

  • Added itmundi/schematic and a basic schema that includes a sections for Pages, Blog, and Team.

1.0.2

  • Added updated config/general.php and config/db.php.

1.0.0

  • initial release