bpez/infuse

Infuse is a laravel admin package for generating administration style interfaces

Tuesday, July 18, 2017
by perezjbryan
Repository
1 Watchers
2 Stars
5,234 Installations

CSS
0 Dependents
0 Suggesters
0 Forks
0 Open issues
51 Versions
0 % Grown

The README.md

Infuse

, _(*1)

Setup

Step 1: Add laravel5 path repo for toddish/verify package, _(*2)

"repositories": [
 {
      "type": "vcs",
      "url": "https://github.com/industrious-mouse/Verify-L4"
  }
],

Step 2: Install via composer, _(*3)

> composer require bpez/infuse:5.*

Step 3: Add the ServiceProvider, _(*4)

// config/app.php
'providers' => [
    ...
    'Bpez\Infuse\InfuseServiceProvider' ,
] ,

Step 4: Add to middleware, _(*5)

// app\http\Kernel.php
protected $middleware = [
  ...
  'Bpez\Infuse\Middleware\InfuseBeforeMiddleware',
  'Bpez\Infuse\Middleware\InfuseAfterMiddleware'
];

Step 5: Configure auth file, _(*6)

// config/auth.php
...
'driver' => 'verify',
'model' => 'InfuseUser',
...
'password' => [
    'email' => 'infuse::emails.password',
    ...
  ],
...

Step 6: Publish Configurations & public assets & run migrations, _(*7)

> 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, _(*8)

"post-update-cmd": [
    ...
    "php artisan vendor:publish --provider="\Bpez\Infuse\InfuseServiceProvider" --tag=infuse_public --force"
],

Step 8: Add to .htaccess, _(*9)


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, _(*10)

> php artisan migrate

Step 10: Add support to server retina images, _(*11)

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., _(*12)

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., _(*13)

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., _(*14)

onlyOne();

addPermanentFilters

Add a SQL where clause to configuration., _(*15)

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., _(*16)

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., _(*17)

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., _(*18)

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:, _(*19)

$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), _(*20)

$optionsArray = array(
  "order_column" => "display_order",
  "order_direction" => "ASC",
  "order_integer" => true
)

Ex. For adding custom export and import functions., _(*21)

$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., _(*22)

$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., _(*23)

displayOrder(array("display_order_column"));

Parameters

Database table field names

fileUpload

Configure columns for file upload functionality., _(*24)

fileUpload(
  array(
    array("column" => "column_name"),
  )
)

Parameters

column - (Required) [string] Database table field name

addCkeditor

Turns a text field to a addCkeditor., _(*25)

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., _(*26)

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., _(*27)

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., _(*28)

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, _(*29)

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., _(*30)

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., _(*31)

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., _(*32)

$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: 1. https://github.com/thumbor/thumbor/wiki 2. https://github.com/99designs/phumbor/blob/master/lib/Thumbor/Url/CommandSet.php, _(*33)

Services configuration required please see service configuration below for setup., _(*34)

$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., _(*35)

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., _(*36)

Util::cdn($url);

Services

/config/services.php, _(*37)

'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 , _(*38)

tag), _(*39)

    {!! Util::infuse() !!}
    </body>
</html>

S3 CORS needs to be enabled and config needed for retina support:, _(*40)

<?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, _(*41)

Do do list, _(*42)

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

The Versions

18/07 2017

dev-master

9999999-dev

Infuse is a laravel admin package for generating administration style interfaces

library infuse

Infuse is a laravel admin package for generating administration style interfaces

bpez/infuse

The README.md

Infuse

Setup

Possible future features

Install artisan on sterioids

Behat infuse test suite

High level data flow

Infuse Configuration API

addSelect

Parameters

describeColumn

Parameters

onlyOne

addPermanentFilters

Parameters

defaultColumnValues

Parameters

addMultiSelect

Parameters

hasMany

Parameters

displayOrder

Parameters

fileUpload

Parameters

addCkeditor

Parameters

callFunction

Parameters

addOtherAction

Parameters

editListingOrder

Parameters

Eloquent ORM

InfuseModel features

url($columnName, $hstoreColumn = false)

thumbor($columnName, $hstoreColumn = false)

Bpez\Infuse\Util

Util::thumbor($url)

Util::cdn($url)

Services

Retina image support

The Versions

dev-master

The Requires

The Development Requires

v5.5.24

The Requires

The Development Requires

dev-develop

The Requires

The Development Requires

v5.5.23

The Requires

The Development Requires

v5.5.22

The Requires

The Development Requires

dev-laravel5_1

The Requires

The Development Requires

v5.5.21

The Requires

The Development Requires

v5.5.20

The Requires

The Development Requires

v5.5.19

The Requires

The Development Requires

dev-version3

The Requires

v5.5.18

The Requires

The Development Requires

v5.5.17

The Requires