.MD files, json-ld updated with faq also twig files updated with faq

config/autoload/app.global.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-$baseUrl = 'https://new.dotkernel.com/';
+$baseUrl = 'https://www.dotkernel.com/';
 $app     = [
     'baseUrl' => $baseUrl,
     'name'    => 'Dotkernel Light | PSR-15 compliant application',

public/llms.txt

@@ -6,36 +6,36 @@ Content spans foundational PHP/middleware architecture (PSR-7, PSR-15, request l
 
 ## Docs
 
-- [Blog](https://new.dotkernel.com/blog/): full list of posts, most recent first, paginated
-- [Categories](https://new.dotkernel.com/categories/): all categories with post counts
-- [About](https://new.dotkernel.com/about/): what Dotkernel Light is
-- [Who We Are](https://new.dotkernel.com/who-we-are/): team/company background
-- [OSS Package Lifecycle](https://new.dotkernel.com/dotkernel-packages-oss-lifecycle/): support/maintenance status of Dotkernel's open-source packages
-- [Contact](https://new.dotkernel.com/contact/)
+- [Blog](https://www.dotkernel.com/blog/): full list of posts, most recent first, paginated
+- [Categories](https://www.dotkernel.com/categories/): all categories with post counts
+- [About](https://www.dotkernel.com/about/): what Dotkernel Light is
+- [Who We Are](https://www.dotkernel.com/who-we-are/): team/company background
+- [OSS Package Lifecycle](https://www.dotkernel.com/dotkernel-packages-oss-lifecycle/): support/maintenance status of Dotkernel's open-source packages
+- [Contact](https://www.dotkernel.com/contact/)
 
 ## Categories
 
-- [Dotkernel](https://new.dotkernel.com/category/dotkernel/): the core framework — releases, caching, sessions, auth, WURFL/device detection (64 posts)
-- [PHP Development](https://new.dotkernel.com/category/php-development/): general PHP tooling, environments, IDEs, security (20 posts)
-- [How to's](https://new.dotkernel.com/category/how-to/): practical guides — migrations, CORS, PSR-7, routing (14 posts)
-- [Best Practice](https://new.dotkernel.com/category/best-practice/): coding standards and database access patterns (13 posts)
-- [Dotkernel API](https://new.dotkernel.com/category/dotkernel-api/): REST API package — auth, content negotiation, OpenAPI (10 posts)
-- [Dotkernel 3](https://new.dotkernel.com/category/dotkernel3/): the v3 rewrite on Zend Expressive/Mezzio (9 posts)
-- [Headless Platform](https://new.dotkernel.com/category/headless-platform/): the current Dotkernel headless architecture (9 posts)
-- [Zend Framework](https://new.dotkernel.com/category/zend-framework/): Zend Framework 1 history and end-of-life notes (8 posts)
-- [Javascript](https://new.dotkernel.com/category/javascript/): frontend/JS topics (3 posts)
-- [Middleware](https://new.dotkernel.com/category/middleware/): PSR-15 middleware and routing internals (3 posts)
-- [Architecture](https://new.dotkernel.com/category/architecture/): request lifecycle and application bootstrapping (3 posts)
-- [PHP Troubleshooting](https://new.dotkernel.com/category/php-troubleshooting/): fixes for common PHP setup issues (2 posts)
-- [Android](https://new.dotkernel.com/category/android/): Android install-referrer and broadcast receivers (2 posts)
-- [PHPStorm](https://new.dotkernel.com/category/phpstorm/): IDE setup (1 post)
-- [Licensing](https://new.dotkernel.com/category/licensing/): open-source license comparisons (1 post)
+- [Dotkernel](https://www.dotkernel.com/category/dotkernel/): the core framework — releases, caching, sessions, auth, WURFL/device detection (64 posts)
+- [PHP Development](https://www.dotkernel.com/category/php-development/): general PHP tooling, environments, IDEs, security (20 posts)
+- [How to's](https://www.dotkernel.com/category/how-to/): practical guides — migrations, CORS, PSR-7, routing (14 posts)
+- [Best Practice](https://www.dotkernel.com/category/best-practice/): coding standards and database access patterns (13 posts)
+- [Dotkernel API](https://www.dotkernel.com/category/dotkernel-api/): REST API package — auth, content negotiation, OpenAPI (10 posts)
+- [Dotkernel 3](https://www.dotkernel.com/category/dotkernel3/): the v3 rewrite on Zend Expressive/Mezzio (9 posts)
+- [Headless Platform](https://www.dotkernel.com/category/headless-platform/): the current Dotkernel headless architecture (9 posts)
+- [Zend Framework](https://www.dotkernel.com/category/zend-framework/): Zend Framework 1 history and end-of-life notes (8 posts)
+- [Javascript](https://www.dotkernel.com/category/javascript/): frontend/JS topics (3 posts)
+- [Middleware](https://www.dotkernel.com/category/middleware/): PSR-15 middleware and routing internals (3 posts)
+- [Architecture](https://www.dotkernel.com/category/architecture/): request lifecycle and application bootstrapping (3 posts)
+- [PHP Troubleshooting](https://www.dotkernel.com/category/php-troubleshooting/): fixes for common PHP setup issues (2 posts)
+- [Android](https://www.dotkernel.com/category/android/): Android install-referrer and broadcast receivers (2 posts)
+- [PHPStorm](https://www.dotkernel.com/category/phpstorm/): IDE setup (1 post)
+- [Licensing](https://www.dotkernel.com/category/licensing/): open-source license comparisons (1 post)
 
 ## Optional
 
-- [Dotkernel Headless Platform: The What's, How's and Why's](https://new.dotkernel.com/headless-platform/dotkernel-headless-platform-the-whats-hows-and-whys/): best starting point for understanding the current platform
-- [Understanding Middleware](https://new.dotkernel.com/architecture/understanding-middleware/)
-- [Request Lifecycle for a Mezzio Based Application](https://new.dotkernel.com/architecture/request-lifecycle-for-a-mezzio-based-application/)
-- [ConfigProvider: Bootstrap Modern PHP Applications](https://new.dotkernel.com/architecture/configprovider-bootstrap-modern-php-applications/)
-- [What is PSR-7 and How to Use It](https://new.dotkernel.com/how-to/what-is-psr-7-and-how-to-use-it/)
-- [Dependency Injection Made Easy in Laminas/Mezzio Applications](https://new.dotkernel.com/dotkernel/dependency-injection-made-easy-in-laminas-mezzio-applications/)
+- [Dotkernel Headless Platform: The What's, How's and Why's](https://www.dotkernel.com/headless-platform/dotkernel-headless-platform-the-whats-hows-and-whys/): best starting point for understanding the current platform
+- [Understanding Middleware](https://www.dotkernel.com/architecture/understanding-middleware/)
+- [Request Lifecycle for a Mezzio Based Application](https://www.dotkernel.com/architecture/request-lifecycle-for-a-mezzio-based-application/)
+- [ConfigProvider: Bootstrap Modern PHP Applications](https://www.dotkernel.com/architecture/configprovider-bootstrap-modern-php-applications/)
+- [What is PSR-7 and How to Use It](https://www.dotkernel.com/how-to/what-is-psr-7-and-how-to-use-it/)
+- [Dependency Injection Made Easy in Laminas/Mezzio Applications](https://www.dotkernel.com/dotkernel/dependency-injection-made-easy-in-laminas-mezzio-applications/)

public/readme/android/listen-for-android-install-referrer.md

@@ -0,0 +1,23 @@
+---
+title: "Listen for Android install referrer"
+description: "Android market broadcasts an intent containing referrer information at install time, before the app is opened, which can be used for install tracking."
+author: "n3vrax"
+date_published: "2011-07-24"
+canonical_url: "https://www.dotkernel.com/android/listen-for-android-install-referrer/"
+category: "Android"
+language: "en"
+---
+
+# Listen for Android install referrer
+
+## Getting Referrer Data at Install Time
+
+Android market sends information at the moment of app install, delivered as a broadcasted intent by Android market at install time - even before the app is opened for the first time. This can be used to create custom links to an Android application, including bits of information about the referrer, sent directly to the app for processing at install. It can be a simple and accurate solution for mobile app install tracking, among other uses.
+
+## FAQ
+
+**Q: Does Android send information when the app is installed?**
+A: Yes. Android market broadcasts an intent containing referrer information at the moment the app is installed.
+
+**Q: When is this referrer information available to the app?**
+A: It's delivered as a broadcasted intent at install time, before the app is ever opened.

public/readme/android/multiple-broadcast-receivers-in-the-same-app-for-the-same-action.md

@@ -0,0 +1,31 @@
+---
+title: "Multiple broadcast receivers in the same app, for the same action"
+description: "Using multiple broadcast receivers to listen separately for the same intent in the same Android app can lead to unexpected results, since one receiver may consume the broadcast and leave the others with nothing."
+author: "n3vrax"
+date_published: "2011-07-22"
+canonical_url: "https://www.dotkernel.com/android/multiple-broadcast-receivers-in-the-same-app-for-the-same-action/"
+category: "Android"
+language: "en"
+---
+
+# Multiple broadcast receivers in the same app, for the same action
+
+## The problem
+
+When multiple broadcast receivers are registered separately to listen for the same intent within the same Android app, this can lead to unexpected results: one broadcast receiver might consume the broadcasted intent, leaving the others with nothing to receive. This can happen when using 3rd party libraries that define their own broadcast receivers alongside an app's own receivers.
+
+## The approach
+
+A solution for this kind of problem is a code snippet inspired by the way Admob for Android solves this, as shown in Admob's own documentation, using meta-data in the manifest file.
+
+## FAQ
+
+**Q: What problem does this article address?**
+A: When multiple broadcast receivers are registered separately to listen for the same intent in the same Android app, this can lead to unexpected results: one broadcast receiver might consume the broadcasted intent, leaving the others with nothing to receive.
+
+**Q: When is this issue most likely to occur?**
+A: This can happen when you use 3rd party libraries that already define their own broadcast receivers alongside your app's own receivers.
+
+## Resources
+
+- [Admob App Download Tracking documentation](http://developer.admob.com/wiki/Android_App_Download_Tracking)

public/readme/architecture/configprovider-bootstrap-modern-php-applications.md

@@ -0,0 +1,111 @@
+---
+title: "ConfigProvider - Bootstrap Modern PHP Applications"
+description: "An overview of the ConfigProvider pattern used in Laminas/Mezzio-based applications, including Dotkernel, to bootstrap middleware pipelines and dependency injection."
+author: "Florin Bidirean"
+date_published: "2025-08-20"
+canonical_url: "https://www.dotkernel.com/architecture/configprovider-bootstrap-modern-php-applications/"
+category: "Architecture"
+language: "en"
+---
+
+# ConfigProvider - Bootstrap Modern PHP Applications
+
+## TL;DR
+
+In PHP, a `ConfigProvider` is a class or callable that is part of an application's bootstrap process, returning configuration data that tells the platform which middleware should run, in what order, and under what conditions. Frameworks like Mezzio, Laminas, Slim, and the Dotkernel Headless Platform use ConfigProviders to declare middleware pipeline configuration, dependency injection mappings, and request handlers, which get merged together automatically during bootstrap (except in Dotkernel, where new ConfigProviders must be registered manually).
+
+## Where Is the ConfigProvider Used?
+
+Mezzio (formerly Zend Expressive), Laminas, Slim, the Dotkernel Headless Platform, and other middleware-based frameworks often have a `ConfigProvider` class. In Laminas/Mezzio specifically, each module or package may contain a `ConfigProvider` that returns:
+
+- Middleware pipeline configuration:
+  - Middleware classes or service names.
+  - Error-handling middleware, which should have the lowest priority.
+  - Middleware groups or nested arrays.
+- Dependency injection mappings.
+- Request Handlers.
+
+Example structure used in Dotkernel:
+
+```php
+class ConfigProvider
+{
+    public function __invoke(): array
+    {
+        return [ /* ... */ ];
+    }
+
+    public function getDependencies(): array
+    {
+        return [
+            'factories'  => [ /* ... */ ],
+            'invokables' => [ /* ... */ ],
+        ];
+    }
+
+    public function getTemplates(): array
+    {
+        return [
+            'paths' => [ /* ... */ ],
+            'error' => [ /* ... */ ],
+        ];
+    }
+}
+```
+
+What each item means:
+
+| Item | Meaning |
+|---|---|
+| `dependencies` | Used by the dependency injector (e.g. laminas-servicemanager) to construct every requested service. |
+| `factories` | The factory builds the service. |
+| `invokables` | The service is built with `new` directly. |
+| `aliases` | Redirects to another service name. |
+| `delegators` | Wraps the original service. |
+| `templates` | Defines the paths for the template files. |
+
+## How the ConfigProvider Works
+
+The ConfigProvider is automatically picked up by the framework during application bootstrap:
+
+1. **Merge the global configuration** - All ConfigProviders are merged into one array.
+2. **Read the configuration array** - A call similar to `$config = $container->get('config') ?? [];` reads an array of entries.
+3. **Resolve item** - `$app->pipe()` is called to resolve one of the following: resolve the service name from the container, wrap the middleware if an array is provided, or call the closure or invokable object.
+4. **Handle errors** - The error-handling middleware is the last one in the pipeline, to make sure it can handle any exceptions.
+5. **Execute at runtime** - Laminas Stratigility iterates over the pipeline in the order it was registered. Each middleware can handle the request and return a response, or delegate execution to the next middleware in the pipeline, until a `ResponseInterface` is returned to the client.
+
+## Benefits
+
+- **Centralized setup** - Instead of hardcoding bootstrap code, it's declared in a config provider so it's easy to read, change, or extend.
+- **Modular** - Each package can ship with its own config without interfering with others.
+- **Container-friendly** - Works well with frameworks using DI containers like Laminas ServiceManager, PHP-DI, or Pimple.
+- **Standardized service definitions** - Consistent rules for object creation, separate from business logic.
+- **Auto-Discovery** - In Laminas/Mezzio, the ConfigAggregator automatically loads and merges all ConfigProviders. Dotkernel is an exception: new ConfigProviders have to be added manually in `config/config.php`, because all the initial ConfigProviders required to install the applications are already injected.
+- **Environment-agnostic** - Returns an array that defines dev, test, or prod environments.
+- **Testability** - The consistent, central configuration promotes isolated (e.g. per-module) testing, easier swapping of dependencies, and assertion of pipeline setup (e.g. checking if a config key is present).
+
+## FAQ
+
+**Q: What is a ConfigProvider in PHP?**
+A: It is a class that is part of an application's bootstrap process: a class or callable that returns configuration data telling the platform which middleware should run, in what order, and sometimes under what conditions.
+
+**Q: What does the ConfigProvider return in the Laminas/Mezzio ecosystem?**
+A: In the Laminas/Mezzio ecosystem, it's literally an array of configuration, settings, or anything else the application needs, and each module or package may contain its own ConfigProvider returning middleware pipeline configuration, dependency injection mappings, and request handlers.
+
+**Q: What is the difference between 'factories' and 'invokables' in the dependencies array?**
+A: `factories` will have the factory build the service, while `invokables` will use `new` directly. You can also use `aliases` to redirect to another service name and `delegators` to wrap the original service.
+
+**Q: How does the ConfigProvider get used during application bootstrap?**
+A: It is automatically picked up by the framework during bootstrap: all ConfigProviders are merged into one array, the configuration array is read, each item is resolved via `$app->pipe()`, the error-handling middleware is placed last in the pipeline, and at runtime Laminas Stratigility iterates over the pipeline in the order it was registered.
+
+**Q: Are new ConfigProviders auto-discovered in Dotkernel?**
+A: Dotkernel is an exception to the usual auto-discovery rule: new ConfigProviders have to be added manually in `config/config.php`, because all the initial ConfigProviders required to install the applications are already injected.
+
+**Q: What are the benefits of using a ConfigProvider?**
+A: Benefits include centralized setup instead of hardcoded bootstrap code, modularity so each package can ship its own config, container-friendliness with DI containers like Laminas ServiceManager, PHP-DI or Pimple, standardized service definitions, environment-agnostic configuration for dev/test/prod, and better testability of the pipeline setup.
+
+## Resources
+
+- [Mezzio Container](https://docs.mezzio.dev/mezzio/v3/features/container/config/)
+- [Laminas Config Aggregator](https://docs.laminas.dev/laminas-config-aggregator/config-providers/)
+- [PSR-15 (HTTP Server Request Handlers)](https://www.php-fig.org/psr/psr-15/)