You've already forked wc-bootstrap
69 lines
2.0 KiB
Markdown
69 lines
2.0 KiB
Markdown
# WooCommerce Bootstrap
|
|
|
|
A WordPress child theme of [WP Bootstrap](https://src.bundespruefstelle.ch/magdev/wp-bootstrap) that overrides all [WooCommerce](https://github.com/woocommerce/woocommerce.git) plugin templates with Bootstrap 5 structures and styling.
|
|
|
|
## Requirements
|
|
|
|
- WordPress 6.7+
|
|
- PHP 8.3+
|
|
- [WP Bootstrap](https://src.bundespruefstelle.ch/magdev/wp-bootstrap) theme (parent)
|
|
- [WooCommerce](https://github.com/woocommerce/woocommerce.git) plugin
|
|
|
|
## Installation
|
|
|
|
1. Install and activate the parent theme `wp-bootstrap`
|
|
2. Install and activate the `woocommerce` plugin
|
|
3. Upload `wc-bootstrap` to `wp-content/themes/`
|
|
4. Run `composer install` in the theme directory
|
|
5. Activate the theme in WordPress Admin > Appearance > Themes
|
|
|
|
## What This Theme Does
|
|
|
|
The WooCommerce plugin ships with its own Twig templates using custom CSS classes. This child theme overrides those templates to use Bootstrap 5 components, ensuring visual consistency with the WP Bootstrap parent theme.
|
|
|
|
### Key Features
|
|
|
|
- Bootstrap 5 markup for all plugin templates
|
|
- Responsive design inheriting WP Bootstrap's grid system
|
|
- Dark mode support via WP Bootstrap's theme toggle
|
|
- Translation-ready
|
|
|
|
## Development
|
|
|
|
### Directory Structure
|
|
|
|
```txt
|
|
wc-bootstrap/
|
|
├── assets/css/ # Custom CSS overrides
|
|
├── assets/js/ # Custom JavaScript
|
|
├── inc/ # PHP classes (PSR-4)
|
|
├── languages/ # Translation files
|
|
├── templates/ # Bootstrap 5 Twig template overrides
|
|
├── composer.json
|
|
├── functions.php
|
|
└── style.css
|
|
```
|
|
|
|
### Building Translations
|
|
|
|
```bash
|
|
for po in languages/wc-bootstrap-*.po; do msgfmt -o "${po%.po}.mo" "$po"; done
|
|
```
|
|
|
|
## Releases
|
|
|
|
Releases are automated via Gitea Actions. Push a tag matching `vX.X.X` to trigger a release build.
|
|
|
|
```bash
|
|
git tag -a v0.1.0 -m "Version 0.1.0 - Initial release"
|
|
git push origin v0.1.0
|
|
```
|
|
|
|
## License
|
|
|
|
GPL-2.0-or-later
|
|
|
|
## Author
|
|
|
|
Marco Grätsch - <https://src.bundespruefstelle.ch/magdev>
|