bpez / infuse
Infuse is a laravel admin package for generating administration style interfaces
Installs: 5 259
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 1
Forks: 0
Open Issues: 0
Language:CSS
Requires
- php: >=5.4.0
- 99designs/phumbor: 1.1.0
- barryvdh/laravel-debugbar: 2.0.5
- bpez/transit: 1.6.*
- intervention/image: 2.1.2
- league/flysystem-aws-s3-v2: ~1.0
- nesbot/carbon: 1.*
- paquettg/php-html-parser: 1.6.3
- toddish/verify: dev-laravel5
Requires (Dev)
- behat/behat: ~3.0@dev
- behat/mink: ~1.7@dev
- behat/mink-extension: ~2.0@dev
- laracasts/behat-laravel-extension: dev-master
- phpspec/phpspec: ~2.1
- phpunit/phpunit: ~4.0
- v5.5.24
- v5.5.23
- v5.5.22
- v5.5.21
- v5.5.20
- v5.5.19
- v5.5.18
- v5.5.17
- v5.5.16
- v5.5.15
- v5.5.14
- v5.5.13
- v5.5.12
- v5.5.10
- v5.5.9
- v5.5.8
- v5.5.7
- v5.5.6
- v5.5.5
- v5.5.4
- v5.5.3
- v5.5.2
- v5.5.1
- v5.5.0
- v5.4.1
- v5.4.0
- v5.3.11
- v5.3.10
- v5.3.9
- v5.3.8
- v5.3.7
- v5.3.6
- v5.3.5
- v5.3.4
- v5.3.3
- v5.3.2
- v5.3.1
- v5.3.0
- v5.2.20
- v5.2.19
- v5.2.18
- v5.2.17
- v5.2.16
- v4.0.0
- v3.4.1
- 2.0.0
- 1.0.0
- dev-develop
- dev-laravel5_1
- dev-version3
This package is not auto-updated.
Last update: 2024-11-09 16:21:57 UTC
README
Setup
Step 1: Add laravel5 path repo for toddish/verify package
"repositories": [ { "type": "vcs", "url": "https://github.com/industrious-mouse/Verify-L4" } ],
Step 2: Install via composer
> composer require bpez/infuse:5.*
Step 3: Add the ServiceProvider
// config/app.php 'providers' => [ ... 'Bpez\Infuse\InfuseServiceProvider' , ] ,
Step 4: Add to middleware
// app\http\Kernel.php protected $middleware = [ ... 'Bpez\Infuse\Middleware\InfuseBeforeMiddleware', 'Bpez\Infuse\Middleware\InfuseAfterMiddleware' ];
Step 5: Configure auth file
// config/auth.php ... 'driver' => 'verify', 'model' => 'InfuseUser', ... 'password' => [ 'email' => 'infuse::emails.password', ... ], ...
Step 6: Publish Configurations & public assets & run migrations
> php artisan vendor:publish --provider="\Bpez\Infuse\InfuseServiceProvider" --tag=infuse_public --force > php artisan vendor:publish --provider="\Bpez\Infuse\InfuseServiceProvider" --tag=infuse_config > php artisan vendor:publish --provider="\Bpez\Infuse\InfuseServiceProvider" --tag=infuse_structure > php artisan migrate --path="vendor/bpez/infuse/migrations"
Step 7: Add to composer.json
"post-update-cmd": [ ... "php artisan vendor:publish --provider="\Bpez\Infuse\InfuseServiceProvider" --tag=infuse_public --force" ],
Step 8: Add to .htaccess
RewriteEngine On
...
RewriteCond %{HTTP:Cookie} devicePixelRatio [NC]
RewriteRule \.(?:jpe?g|gif|png|bmp)$ bpez/infuse/other/retinaimages.php [NC,L]
Step 9: Run infuse migrations
> php artisan migrate
Step 10: Add support to server retina images
RewriteCond %{HTTP:Cookie} devicePixelRatio [NC]
RewriteRule \.(?:jpe?g|gif|png|bmp)$ /packages/bpez/infuse/retinaimages.php [NC,L]
Possible future features
> https://github.com/websoftwares/Throttle
> http://laravel.com/docs/cache
> https://github.com/frenzyapp/turbolinks
> https://github.com/rails/turbolinks
> https://github.com/kossnocorp/jquery.turbolinks
Install artisan on sterioids
> sudo curl https://raw.github.com/villimagg/Artisan-on-Steroids/master/artisan -o /usr/local/bin/artisan && sudo chmod +x /usr/local/bin/artisan
Behat infuse test suite
imports:
- vendor/bpez/infuse/behat.yml
High level data flow
model(mapConifig -> getbModelInstance(s) -> boot -> apiCalls) -> process(route -> renderView)
Infuse Configuration API
addSelect
Turn database field to a html form select. Take in single instanct or multiple.
addSelect(array( array( "column" => $columnName, "array" => array(), "insertBlank" => false, "topSelect" => false, "nested" => $nested, "nestedLastArray" => $nestedLastArray ) ), ... );
Parameters
- column - (Required) [string] Database table field name
- array - (Required) [array] Array of values. Formatted:
array( array('id' => 1, ", 'name' => 'display name'), array('id' => 2, ", 'name' => 'display name'), ... )
- insertBlank - (Optional) [boolean] Inserts a blank option to select field. Default value is false.
- nested - (Optional) [array] Model only needed for first one. Every level after that array format required
$nested = array( "Floorplan", array("model" => "ImageAsset", "column" => "title") );
- nestedLastArray - (Optional) [array] Array of level values
$nestedLastArray = array( array('id' => 1, ", 'name' => 'display name'), array('id' => 2, ", 'name' => 'display name'), ... );
describeColumn
Adds a description to a database field.
describeColumn(array( array( "column" => $columnName, "desc" => "description here", "popover" => true ) ... );
Parameters
- column - (Required) [string] Database table field name
- desc - (Required) [string] Description
- popover (Optional) [boolean] If option present then descript displayed as html pop.
onlyOne
Only allow one database entry to be display and created.
onlyOne();
addPermanentFilters
Add a SQL where clause to configuration.
addPermanentFilters(array( array( "column" => $columnName, "operator" => "=", "value" => 87 ) ... );
Parameters
- column - (Required) [string] Database table field name
- operator - (Required) [string] SQL comparison opertator. If 'IN' is used for the operator then it use elequents whereIn($column, $value)
- value - (Required) [string | number] Value to be compared to
defaultColumnValues
Add a default value for when an entry is saved.
defaultColumnValues(array( "column_name_1" => $value1, "column_name_2" => $value2, ... );
Parameters
- array - (Required) [array] Array of default values where the index is the column name and the value is the value for the index
addMultiSelect
Transform field to multiple select. Where IDs are kept track separated by a coma.
addMultiSelect(array( array( "column" => $columnName, "array" => array(), ), ... );
Parameters
- column - (Required) [string] Database table field name
- array - (Required) [array] Array of values. Formatted
array( array('id' => 1, ", 'name' => 'display name'), array('id' => 2, ", 'name' => 'display name'), ... )
hasMany
One To Many relationships are defined here. Define children relations like format below.
hasMany(array( array("SomeModelName", "Display Name", array("column_name_1", "column_name2"...) $optionsArray), ... );
Parameters
- (Required) [string] Child model name
- (Required) [string] Display name for entries listed on parent edit page
- (Required) [array] Child columns to display on entries listed on parent edit page
- (Optional) [array] Contains extra functionality for dislaying child entries. Some options are as follows:
Ex. Child Columns array may have an array nested to match an id with a value like below:
$childColumnArray = array( "column_1", "column_2", array("column_3" => array( array("id" => 1, "name" => "some name"), array("id" => 2, "name" => "some name 2") ), "column_4", ... )
array("category" => $categories)
$optionsArray = array( "order_column" => "display_order", "order_direction" => "ASC", "order_integer" => true )
Ex. For adding custom export and import functions.
$optionsArray = array( "import_csv_function" => "importUserModelInstancMethod", "import_csv_function_url" => "/path/to/example/template.csv", "import_csv_function_text" => "Import CSV for users. Use template provided.", "export_csv_function" => "exportUserModelInstanceMethod", "export_csv_function_text" => "Export CSV template to import.", )
Ex. Split table to act like 2 child tables separated by where clauses.
$optionsArray = array( "split" => array( "Gallery Assets" => "main_gallery = 1", "Gallery 2 Assets" => "main_gallery = 0" ) )
displayOrder
Changes column to an column to be used for ordering entries. Integer is used for the type. Makes field not editable by user and value automatically set.
displayOrder(array("display_order_column"));
Parameters
- Database table field names
fileUpload
Configure columns for file upload functionality.
fileUpload( array( array("column" => "column_name"), ) )
Parameters
- column - (Required) [string] Database table field name
addCkeditor
Turns a text field to a addCkeditor.
addCkeditor( array("column_name_1", "column_name_2", ...) )
Parameters
- Database table field names
callFunction
Add extra action to entry's actions (show | edit | delete | YourActionHere ). Returning an array("type" => "success", "message" => $message) can tap into notification system. Type can be ("success" || "error" || "info" || "warning"). Or returning false will trigger default error message.
callFunction(array( array( "function" => "importSomeThing", "display_name" => "Import some thing", "long_process" => "Processing please wait...", "target" => "_BLANK" ), ... );
Parameters
- (Required) [string] function - Name of the function. Its a laravel elequent query scope. So if name is importSomeThing then in the model it's declared scopeImportSomeThing
- (Required) [string] Display name for the function
- (Optional) [string] If its a lengthy process you can set a message that will populate a waiting modal while the process is running.
- (Optional) [string] Provide a target for the html anchor tag.
Ex. importSomeThing implementation. Returns an array to the admin marked with type ("success" || "error") and message along with it.
public function importSomeThings() { // ... some work here $message = "Thanks"; return array("type" => "success", "message" => $message); }
addOtherAction
Add top level action under the "Other Actions" dropdown on the scaffold listing page. Function should be static function from the top level model. User instance is passed into static function. Returning an array("type" => "success", "message" => $message) can tap into notification system. Type can be ("success" || "error" || "info" || "warning"). Or returning false will trigger default error message.
addOtherAction(array( array( "function" => "seedUrls", "display_name" => "Import some thing", ), ... );
Parameters
- (Required) [string] function - Name of the function. Its a laravel elequent query scope. So if name is importSomeThing then in the model it's declared scopeImportSomeThing
- (Required) [string] Display name for the function
Ex. seedUrls implementation
public function seedUrls($currentUser) { // ... some work here $message = "Thanks"; return array("type" => "success", "message" => $message); }
editListingOrder
Lets you select the column ordering for the edit/create page. Pass in an array with the column names in the desired order.
editListingOrder(array( "created_at", "updated_at", "destination_site", "display_state", "property", "mobile_video_img", "sub_title", "video", "title", ));
Parameters
- (Required) [string] table field names
Eloquent ORM
Setup models to work with infuse by extending the InfuseModel and using InfuseModelLibrary trait.
class BlogPost extends InfuseModel { use InfuseModelLibrary; }
InfuseModel features
url($columnName, $hstoreColumn = false)
Fetch the full url path for the file name saved to the specific column. Call the url method and pass in the column name as a parameter.
$post = new BlogPost; $post->url($columnName); // Will return a url similar to http://somedomain.com/upload/some/path/name.jpg
thumbor($columnName, $hstoreColumn = false)
Building on top of url functionality return an instance of a thumbor client. Only works on columns the have a file saved to them. Thumbor is a smart imaging service. It enables on-demand crop, resizing and flipping of images. Thumbor documentation and thumber client documentation can found here:
- https://github.com/thumbor/thumbor/wiki
- https://github.com/99designs/phumbor/blob/master/lib/Thumbor/Url/CommandSet.php
Services configuration required please see service configuration below for setup.
$post = new BlogPost; $post->thumbor($columnName)->smartCrop(true)->resize(699, 525); // Will return a url to the cropped or filtered version
- When using with img tags add this data attribute: data-no-retina
<?php $post = new BlogPost; ?> <img src="{{$post->thumbor($columnName)->smartCrop(true)->resize(699, 525)}}" data-no-retina />
Bpez\Infuse\Util
Util::thumbor($url)
Same functionality as InfuseModel url method. For other image resources.
Util::thumbor($url);
- When using with img tags add this data attribute: data-no-retina
<?php $post = new BlogPost; ?> <img src="{{Util::thumbor($url)->smartCrop(true)->resize(699, 525)}}" data-no-retina />
Util::cdn($url)
For delivering assets originating from same origin through CloudFront CDN. Services configuration required please see service configuration below for setup.
Util::cdn($url);
Services
/config/services.php
'thumbor' => [ // Thumbor security key here 'security-key' => '843208u4325032u502532582358235', // Use cloudfront in front of thumbor for scalability. 'host' => 'http://d443523423.cloudfront.net', ], 'cloudfront' => [ // Distribution domain for file uploaded through infuse. 's3-uploads' => 'http://d4253425.cloudfront.net', // Distribution domain for assets originating from same origin. 'self-hosted' => 'http://d54343425.cloudfront.net', ],
Retina image support
Include the Util::infuse() on your page (put it at the bottom of your template, before your closing tag)
{!! Util::infuse() !!} </body> </html>
S3 CORS needs to be enabled and config needed for retina support:
<?xml version="1.0" encoding="UTF-8"?> <CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <CORSRule> <AllowedOrigin>*</AllowedOrigin> <AllowedMethod>GET</AllowedMethod> <AllowedMethod>HEAD</AllowedMethod> <MaxAgeSeconds>3000</MaxAgeSeconds> <AllowedHeader>Authorization</AllowedHeader> </CORSRule> </CORSConfiguration>'self-hosted' => 'http://d54343425.cloudfront.net', ],
Created with http://dillinger.io
Do do list
- add delete to infuse delete and then add method that can be used for deleting children
- redo generateThumbnail in model library then remove fron composer.json
- replace pages uploading functionality