Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tobyink/wp-base2023
Wordpress starter
https://github.com/tobyink/wp-base2023
bootstrap5 composer roots-sage wordpress
Last synced: 8 days ago
JSON representation
Wordpress starter
- Host: GitHub
- URL: https://github.com/tobyink/wp-base2023
- Owner: tobyink
- License: gpl-2.0
- Created: 2023-02-07T05:26:31.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-03-21T21:22:20.000Z (almost 2 years ago)
- Last Synced: 2024-10-27T18:08:36.395Z (about 2 months ago)
- Topics: bootstrap5, composer, roots-sage, wordpress
- Language: PHP
- Homepage: https://toby.ink/blog/2023/02/07/setting-up-wordpress-in-2023/
- Size: 730 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: .github/README.md
- License: LICENSE
Awesome Lists containing this project
README
# Wordpress Starter 2023
Setup a simple Wordpress 6.x site powered by the Sage+Bootstrap-based [Thyme](https://github.com/tobyink/wp-thyme-theme) theme.
If you need to customize this base, fork this repo (and maybe Thyme's repo too) and use the URLs to your forked versions instead of the originals.
## Assumptions
* You have SSH access to a Linux+Apache web host
* You have a blank MySQL/MariaDB database
* PHP and PHP Composer are installed and working on the web host, along with any optional components Wordpress and Roots Sage need
* You have a domain name (or subdomain) pointed at the host
* Node JS, npm, and yarn are installed and working on the web host
* git is installed and working on the web host
## Begin
```shell
cd $HOME/sites/test.site.example
git clone https://github.com/tobyink/wp-base2023.git .
composer install
cp wp-config.php.example wp-config.php
$EDITOR wp-config.php
```
Change the `$domain` and optionally `$table_prefix`.
Change the database connection settings.
Change the crypto stuff to some freshly generated random strings.
Double check the rest looks sane.
We're in business.
## Basic Wordpress setup
1. Visit the site in your browser and run through Wordpress's usual procedure.
2. Go to the **Plugins** page in the backend and enable all the plugins.
Note: the Wordpress backend will be at `https://$domain/wordpress/wp-admin/`.
Notice the extra path component.
## Building the Thyme theme
If you're going to use a different theme, you can stop reading here.
```shell
cd $HOME/sites/test.site.example
cd wp-content/plugins/
git clone https://github.com/roots/acorn.git acorn
cd acorn
git checkout 2.x
composer install
cd ../../..
git clone https://github.com/tobyink/wp-thyme-theme.git thyme
cd wp-content/themes/
ln -s ../../thyme/ thyme
cd ../../thyme/
composer install
yarn install
yarn build
chmod -R ugo+rwX public/ resources/styles/common/_wp_theme.scss
```
## Theme setup
1. Return to the **Plugins** page in the Wordpress backend and enable the Acorn plugin.
2. Go to **Appearance** and switch to the Thyme theme.
3. Go to the **Sections** and **Theme Options** page in the backend, make a random change to the default values, and hit "Update" in each. This should force the theme CSS files to rebuild themselves.