https://github.com/tbrennan77/thisgeneration
This is a custom WordPress theme for Christian Media International (CMI). The theme is completely custom and is built with Carbon Fields from HTML Burger. Build with Yarn and Composer.
https://github.com/tbrennan77/thisgeneration
carbon-field php theme wordpress
Last synced: about 2 months ago
JSON representation
This is a custom WordPress theme for Christian Media International (CMI). The theme is completely custom and is built with Carbon Fields from HTML Burger. Build with Yarn and Composer.
- Host: GitHub
- URL: https://github.com/tbrennan77/thisgeneration
- Owner: tbrennan77
- Created: 2021-02-18T01:02:52.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-04-20T15:27:02.000Z (about 5 years ago)
- Last Synced: 2025-07-09T06:06:13.237Z (12 months ago)
- Topics: carbon-field, php, theme, wordpress
- Language: SCSS
- Homepage:
- Size: 24.8 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# This Generation Wordpress Theme
This is a custom WordPress theme for Christian Media International (CMI). The goal of CMI is to reach the world with the gospel in this generation. The theme name is taken from that mission statement.
The theme is completely custom and is built with [Carbon Fields](https://carbonfields.net/) from [HTML Burger](https://htmlburger.com/). The development is being led by [Tim Brennan](https://github.com/tbrennan77) with design by Brandon McCurdy. The technical documentation that is specific to this theme is located in the `wp-content/themes/thisgeneration` directory. Please reference that for specific functionality questions, install, setup and running this project locally.
## Getting Started
Follow these steps to run this project locally:
1. Download a fresh copy of [WordPress](https://wordpress.org/download/) to your local machine in your project or websites directory.
2. `cd` into the root folder of `your/project/directory/` and `git clone git@github.com:tbrennan77/thisgeneration.git`
3. Run a database update from the `/Migrations` directory to get the latest version of the database. If you use phpMyAdmin or similar you can download the latest copy from the `/migrations` directory and upload that into you database via the phpMyAdmin Import tool.
4. Edit the `wp-config.php` file to point to your specific database (ie `localhost` with your `username` and `password`).
5. Refer to the technical documentation in the `wp-content/themes/thisgeneration` directory for instructions on running the project locally. The project is designed to be run via `yarn` but can be run using most 3rd party tools like `MAMP`, `WAMP` or similar.
## Collaboration
TODO: add details here on `Git` and collaborating...
1. Push to GitHub
2. Push to Staging [read this for the automatic git deploy setup](https://anchor.host/automatic-git-deploy-with-kinsta-via-ssh/)
# Carbon Fields
This theme is built around the amazing [Carbon Field](https://carbonfields.net/) library from our friends and project partners at [htmlBurger](https://htmlburger.com/). Carbon Fields is much more developer-centric than Advanced Custom Fields (ACF) or similar custom fields libraries that may exist. With Carbon Fields the custom fields are defined via PHP and not an admin UI. So while there may be less control over the general setup there is much more flexibility and customizations than is possible with ACF. Additionally changes are part of the Git history. Below are some of the initial custom fields that are built into this project:
## Logos
The logos can be updated directory by replacing these two files:
1. Header logo - `/wp-content/themes/thisgeneration/resources/images/logo.png`
2. Footer logo - `/wp-content/themes/thisgeneration/resources/images/logo-circle.png`
## Header
The header shows a standard WordPress menu location and a button.
The menu is managed from [WordPress menus](nav-menus.php). The button is managed from [Theme options](admin.php?page=crbn-theme-options.php)
## Footer
1. The footer shows three menu locations, socials, copyright text and optionally another logo on top.
2. It also shows a background image.
3. The menu locations are managed from [WordPress menus](nav-menus.php)
4. The social icon links, copyright text and background image are managed from [Theme options](admin.php?page=crbn-theme-options.php)
## Theme Options
1. Manage header, footer and socials
2. The callout shown at the bottom of blog pages
3. You can optionally add scripts to header and footer (no need for additional plugin for this)
## Post
To edit the blue text in the top part of the single post page and the excerpt in the blog listing, edit the text in the excerpt section to the right in the post edit page
## Page Templates
### Section Builder
Use many different sections to build a page.
Has a checkbox to show or hide the additional footer logo.
## Shortcodes
### [year]
The [year] shortcode shows the current year
Example usage:
The current year is [year] .