PHPackages owenmelbz/illumipress - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Templating & Views](/categories/templating) 4. / 5. owenmelbz/illumipress ActiveLibrary[Templating & Views](/categories/templating) owenmelbz/illumipress ===================== Simple wrapper for the illuminate support, http response, request, validation, zttp, cache, encryption, blade templating and whoops error handler for WordPress 0.0.17(7y ago)142571MITPHP Since Mar 24Pushed 7y agoCompare [ Source](https://github.com/OwenMelbz/illumipress)[ Packagist](https://packagist.org/packages/owenmelbz/illumipress)[ RSS](/packages/owenmelbz-illumipress/feed)WikiDiscussions master Synced 2w ago READMEChangelog (2)Dependencies (8)Versions (18)Used By (0) [![IllumiPress logo](https://camo.githubusercontent.com/fa3fdaef3faea5518fb6dcbfd0a1a5c3318618447b948178f5c708bc2541fb03/68747470733a2f2f73766773686172652e636f6d2f692f3634712e737667)](https://camo.githubusercontent.com/fa3fdaef3faea5518fb6dcbfd0a1a5c3318618447b948178f5c708bc2541fb03/68747470733a2f2f73766773686172652e636f6d2f692f3634712e737667) IllumiPress =========== [](#illumipress) IllumiPress is a simple wrapper for some of the laravel 5 illuminate packages, it allows users to integrate some of the joyful features of Laravel into wordpress. We currently integrate WordPress with Laravel Blade, HTTP Requests, Responses, Validator and Support (e.g collections, dd, string helpers etc), ZTTP, Caching (redis, memcached, file) and Ecryption Installation ------------ [](#installation) The easiest way to install is via composer e.g `composer require owenmelbz/illumipress` from within your project root. Even if your project is not using composer you can use the above command, but then you must manually include `vendor/autoload.php` in your project, for WordPress consider using the `functions.php` Features -------- [](#features) As the illuminate packages require the illuminate/support package, you also get access to an array of magic such as - collections via `collect` - both `dump` and `dd` - array helpers such as `data_get`, `array_wrap`, `array_dot` etc - string helpers e.g `ends_with`, `starts_with`, `str_contains`, `str_random` - logical helpers such as `optional`, `tap`, `throw_if` - access to Guzzle via `kitetail\zttp` and a `http()` helper - laravel blade template rendering using `filename.blade.php` allowing `view('component.sidebar')` etc You can see a full list of included components Usage ----- [](#usage) The package has a child class which extends the core illuminate classes to add some additional helper functions. Request Class ------------- [](#request-class) This does not currently have any custom functionality, you should be able to use the documentation provided - you have access to a global helper `request()` to get a new instance of the request object, so you can do things such as `request()->get('my_posted_data', 'default value')` etc. Response Class -------------- [](#response-class) The main difference between the Laravel and this implementation is that typically you must manually use Symfony's "send()" method to complete the request e.g. ``` return response(['hello' => 'world'])->send(); ``` There are however custom helpers on top to provide a consistent ajax style responses, `ajax(), success(), error()` ``` // alias of ->success() // Sends a JSON response formatted into a JSONSchema'esque structure return response([ 'hello' => 'world' ])->ajax(); // Returns 200 header { "data": {"hello": "world"}, "meta": {"success": true} } // You can also send a JSON response with error headers return response('Sorry something went wrong')->error(422); // Returns a 422 error { "data": "Sorry something went wrong", "meta": {"success": false} } ``` You can also add custom meta to the response, useful for things such as "next" and "prev" data. ``` return response('My response')->addMeta(['key' => 'value'])->send(); ``` You can completely overwrite the meta using `setMeta` method. Validation class ---------------- [](#validation-class) This provides 2 extra methods on top of the validation class, firstly the ability to return a formatted list of errors using `$validator->formattedErrors()` and an ajax result using the previously mentioned automatic formatting by `$validator->response()`. You have the full validation class () under there to use such as ``` $validator = validator(request()->all(), [ 'name' => 'required', 'email' => 'required|email' ]); if ($validator->fails()) { return $validator->response(); } // Outputs { "data": [ { "param": "name", "messages": [ "the name field is required", ] } ], "meta": { "success": false } } ``` By default we only include the default Laravel i18n error messages, you can follow the Laravel documentation for passing in custom messages If you need to use translations you can load your custom messages file e.g ``` $validator = validator($data, $rules); $validator->setLanguageFile(__DIR__ . '/i18n/french.php'); ``` Laravel Blade ------------- [](#laravel-blade) Blade has also been included to allow a more fluent syntax for rendering templates. By default it is disabled - however you can turn it on by using `turn_blade_on()` and to turn off using `turn_blade_off()` If you name your files `template.blade.php` Blade can render the template directly, however, if you enable blade and have normal `template.php` files, it will create a dynamic copy within the `wp-content/uploads/.cache/` which will update each time you make a file change. The integration is loosely based off which means you get some starter directives such as: ``` @post {{ the_title() }} @field('page_intro') @has('extra_intro') @field('extra_intro') @endhas @repeater('services') @subfield('service_name') @endrepeater @wpquery(['author_id' => 21]) {{ the_title() }} @endwpquery @endpost ``` You can return a rendered view by using the `view('components.sidebar')` helper Cache ----- [](#cache) The `illuminate\cache` package is also included which is available by a global `cache()` helper, so you can do things such as `cache()->put('user_10', 'Taylor')` etc. Currently you can use the file, memcached and redis driver for caching with some basic configurations, Config items are exposed by the following CONSTANTS. - Redis -- `REDIS_CONNECTION` (default = `default`) -- `REDIS_PREFIX` (default = `illumipress`) -- `REDIS_HOST` (default = `127.0.0.1`) -- `REDIS_PORT` (default = `6379`) - File -- `ILLUMINATE_CACHE` (default = `wp-uploads/.cache`) - Memcached -- `MEMCACHED_PREFIX` (default = `illumipress`) -- `MEMCACHED_HOST` (default = `127.0.0.1`) -- `MEMCACHED_PORT` (default = `11211`) An example usage may be ``` define('ILLUMINATE_CACHE', './cache'); $tweets = cache()->remember('recent_tweets', $cacheLifeTimeInMinutes = 20, function () { return $tweets = http('https://twitter.com/illumipress.json'); )); ``` Encryption ---------- [](#encryption) The `illuminate/encrypter` is also included for handling certain sensitive data which can be used via the the `encryption` global helper. By default it will look for a constant called `ILLUMINATE_ENCRYPTION_KEY` which should be a 16 character key which will be used to encrypt the data. Of course you might want to make this unique to each user, to prevent other users decrypting others data. You can pass in your own encryption key into the helper e.g ``` $enc = encryption($user->private_key); $encryptedData = $enc->encrypt('My secret'); $decryptedData = $enc->decrypt($encryptedData); echo $decryptedData; // My Secret ``` Whoops ------ [](#whoops) By default (sorry) we turn on the `filp/whoops` error handler to enable more friendly errors. You can turn this off and on via `turn_whoops_off()` and `turn_whoops_on()` However when your WordPress configuration defines `WP_DEBUG_DISPLAY` as `false` Whoops will disable itself - regardless of what you type. HTTP Client / Guzzle / cURL / zttp ---------------------------------- [](#http-client--guzzle--curl--zttp) We also include the `kitetail/zttp` library for a simple curl access via the `http()` helper, for full information we recommend checking out the zttp GitHub documentation ``` $stringResponse = http('https:/www.google.com'); ``` for a simple curl GET request you can use the above, for more complicated requests you can use the fuller syntax, which returns an instance of `ZttpResponse` ``` $response = http()->post('https://www.google.com/', ['q' => 'my query']); if ($response->isOkay()) { echo $response->body(); echo $response->json(); echo etc... } ``` As `zttp` uses Guzzle under the hood, which means you can also get access to the full guzzle suite and do things such as `(new Guzzle\Client)->setBaseUri('https://www.google.com/')->post('search', ['q' => 'query''])`; License ------- [](#license) This is a completely free and open source project, feel free to use it for anything you like, if you wish to modify and redistribute it, however, please give some credit back to the original repository. ### Health Score 30 — LowBetter than 62% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity19 Limited adoption so far Community7 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~19 days Recently: every ~70 days Total 17 Last Release 2702d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/1094740?v=4)[Owen Melbourne](/maintainers/OwenMelbz)[@OwenMelbz](https://github.com/OwenMelbz) --- Top Contributors [![OwenMelbz](https://avatars.githubusercontent.com/u/1094740?v=4)](https://github.com/OwenMelbz "OwenMelbz (55 commits)") --- Tags bladeilluminatelaravelwordpress ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/owenmelbz-illumipress/health.svg) ``` [![Health](https://phpackages.com/badges/owenmelbz-illumipress/health.svg)](https://phpackages.com/packages/owenmelbz-illumipress) ``` ### Alternatives [roots/acorn Framework for Roots WordPress projects built with Laravel components. 9772.3M122](/packages/roots-acorn)[psalm/plugin-laravel Psalm plugin for Laravel 3345.1M337](/packages/psalm-plugin-laravel)[laravel/pulse Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application. 1.7k14.1M124](/packages/laravel-pulse)[spatie/laravel-responsecache Speed up a Laravel application by caching the entire response 2.8k8.7M64](/packages/spatie-laravel-responsecache)[laravel/mcp Rapidly build MCP servers for your Laravel applications. 77018.2M124](/packages/laravel-mcp)[pressbooks/pressbooks Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS. 45344.0k1](/packages/pressbooks-pressbooks) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)