From 48497708505e44717da83b7f92eaf841cf25f8e2 Mon Sep 17 00:00:00 2001 From: indykoning <15870933+indykoning@users.noreply.github.com> Date: Wed, 24 Sep 2025 17:05:19 +0200 Subject: [PATCH 1/5] Added docs telling you about the .env differences --- src/4.x/installation.md | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/src/4.x/installation.md b/src/4.x/installation.md index 7686d07..0542e9d 100644 --- a/src/4.x/installation.md +++ b/src/4.x/installation.md @@ -118,19 +118,17 @@ If you do not have a Magento 2 installation yet, you want to test Rapidez, or li Make sure Docker can use at least 4GB of memory! ::: +If you have no web hosting running on your laptop (or simply want to use a self-contained version of the project) consider using `.env.example.traefik` as your `.env`. +This will use [Traefik](https://traefik.io/traefik) to make [http://rapidez.localhost](http://rapidez.localhost) available without any configuration necessary. + +Otherwise opt for `.env.example.docker` for your `.env`. +This will give you the reigns, exposing the websites on the ports defined in the `.env.example.docker` +(by default, magento: [http://127.0.0.1:1234](http://127.0.0.1:1234), rapidez: [http://127.0.0.1:1235](http://127.0.0.1:1235), elasticsearch: [http://127.0.0.1:9200](http://127.0.0.1:9200)) + ```bash docker-compose up -d docker exec rapidez_magento magerun2 indexer:reindex ``` -Edit the `.env` - -```dotenv -MAGENTO_URL=http://localhost:1234 -DB_PORT=3307 -DB_DATABASE=magento -DB_USERNAME=magento -DB_PASSWORD=password -``` ## Standalone Checkout From 3899516b3bb322b8bf6c18c8955041c32807716b Mon Sep 17 00:00:00 2001 From: indykoning <15870933+indykoning@users.noreply.github.com> Date: Thu, 25 Sep 2025 13:48:35 +0200 Subject: [PATCH 2/5] Commit suggestions Co-authored-by: Jade Geels --- src/4.x/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/4.x/installation.md b/src/4.x/installation.md index 0542e9d..71c30db 100644 --- a/src/4.x/installation.md +++ b/src/4.x/installation.md @@ -122,7 +122,7 @@ If you have no web hosting running on your laptop (or simply want to use a self- This will use [Traefik](https://traefik.io/traefik) to make [http://rapidez.localhost](http://rapidez.localhost) available without any configuration necessary. Otherwise opt for `.env.example.docker` for your `.env`. -This will give you the reigns, exposing the websites on the ports defined in the `.env.example.docker` +This will give you the reins, exposing the websites on the ports defined in the `.env.example.docker` (by default, magento: [http://127.0.0.1:1234](http://127.0.0.1:1234), rapidez: [http://127.0.0.1:1235](http://127.0.0.1:1235), elasticsearch: [http://127.0.0.1:9200](http://127.0.0.1:9200)) ```bash From 500ea1153f7b7f34cfffb297ea4c729ae75b7a28 Mon Sep 17 00:00:00 2001 From: indykoning <15870933+indykoning@users.noreply.github.com> Date: Tue, 24 Feb 2026 11:14:57 +0100 Subject: [PATCH 3/5] Renamed webhosting to webserver --- src/4.x/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/4.x/installation.md b/src/4.x/installation.md index 71c30db..e053e75 100644 --- a/src/4.x/installation.md +++ b/src/4.x/installation.md @@ -118,7 +118,7 @@ If you do not have a Magento 2 installation yet, you want to test Rapidez, or li Make sure Docker can use at least 4GB of memory! ::: -If you have no web hosting running on your laptop (or simply want to use a self-contained version of the project) consider using `.env.example.traefik` as your `.env`. +If you have no webserver running on your laptop (or simply want to use a self-contained version of the project) consider using `.env.example.traefik` as your `.env`. This will use [Traefik](https://traefik.io/traefik) to make [http://rapidez.localhost](http://rapidez.localhost) available without any configuration necessary. Otherwise opt for `.env.example.docker` for your `.env`. From 7bf5e40a485171c398c2d17c318f1b1ca92c2875 Mon Sep 17 00:00:00 2001 From: indy koning Date: Tue, 31 Mar 2026 17:09:10 +0200 Subject: [PATCH 4/5] Added docs on statamic meta titles on Magento entities --- src/4.x/packages/statamic.md | 15 +++++++++++++++ src/5.x/packages/statamic.md | 15 +++++++++++++++ 2 files changed, 30 insertions(+) diff --git a/src/4.x/packages/statamic.md b/src/4.x/packages/statamic.md index bef77e9..40af244 100644 --- a/src/4.x/packages/statamic.md +++ b/src/4.x/packages/statamic.md @@ -226,6 +226,21 @@ rapidez-sitemaps/{store_id}/{sitemap_prefix}_taxonomy_{taxonomy_handle}.xml With the [default rapidez/sitemap config](https://github.com/rapidez/sitemap/blob/master/config/sitemap.php), the prefix default is `statamic_sitemap_` and can be configured within `config/rapidez/statamic.php` +## Meta title and description + +If you want to use Statamic for managing your meta title and description you will have to add it to your templates. +As an example, the category pages: +`vendor/rapidez/core/resources/views/category/overview.blade.php` +```diff + @extends('rapidez::layouts.app') + +- @section('title', $category->meta_title ?: $category->name) +- @section('description', $category->meta_description) ++ @section('title', $content?->meta_title ?: $category->meta_title ?: $category->name) ++ @section('description', $content?->meta_description ?: $category->meta_description) + @section('canonical', url($category->url)) +``` + ## Static caching Statamic comes with [static caching](https://statamic.dev/static-caching) and with this packages we're adding the middleware that handles that from Statamic to all Rapidez web routes. When you configure static caching with Statamic it will also be applied to all Rapidez routes! diff --git a/src/5.x/packages/statamic.md b/src/5.x/packages/statamic.md index 455e62e..be7f73c 100644 --- a/src/5.x/packages/statamic.md +++ b/src/5.x/packages/statamic.md @@ -226,6 +226,21 @@ rapidez-sitemaps/{store_id}/{sitemap_prefix}_taxonomy_{taxonomy_handle}.xml With the [default rapidez/sitemap config](https://github.com/rapidez/sitemap/blob/master/config/sitemap.php), the prefix default is `statamic_sitemap_` and can be configured within `config/rapidez/statamic.php` +## Meta title and description + +If you want to use Statamic for managing your meta title and description you will have to add it to your templates. +As an example, the category pages: +`vendor/rapidez/core/resources/views/category/overview.blade.php` +```diff + @extends('rapidez::layouts.app') + +- @section('title', $category->meta_title ?: $category->name) +- @section('description', $category->meta_description) ++ @section('title', $content?->meta_title ?: $category->meta_title ?: $category->name) ++ @section('description', $content?->meta_description ?: $category->meta_description) + @section('canonical', url($category->url)) +``` + ## Static caching Statamic comes with [static caching](https://statamic.dev/static-caching) and with this packages we're adding the middleware that handles that from Statamic to all Rapidez web routes. When you configure static caching with Statamic it will also be applied to all Rapidez routes! From 4965cf6c4d1d764d8741899b1ebe14c6803f7555 Mon Sep 17 00:00:00 2001 From: indy koning Date: Tue, 7 Apr 2026 16:48:09 +0200 Subject: [PATCH 5/5] Added doc for V5 as well --- src/5.x/installation.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/src/5.x/installation.md b/src/5.x/installation.md index f617831..ec92a28 100644 --- a/src/5.x/installation.md +++ b/src/5.x/installation.md @@ -104,6 +104,13 @@ If you do not have a Magento 2 installation yet, you want to test Rapidez, or li Make sure Docker can use at least 4GB of memory! ::: +If you have no webserver running on your laptop (or simply want to use a self-contained version of the project) consider using `.env.example.traefik` as your `.env`. +This will use [Traefik](https://traefik.io/traefik) to make [http://rapidez.localhost](http://rapidez.localhost) available without any configuration necessary. + +Otherwise opt for `.env.example.docker` for your `.env`. +This will give you the reins, exposing the websites on the ports defined in the `.env.example.docker` +(by default, magento: [http://127.0.0.1:1234](http://127.0.0.1:1234), rapidez: [http://127.0.0.1:1235](http://127.0.0.1:1235), elasticsearch: [http://127.0.0.1:9200](http://127.0.0.1:9200)) + ```bash docker-compose up -d docker exec rapidez_magento magerun2 indexer:reindex