PHPackages                             bpez/infuse - 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. [Admin Panels](/categories/admin)
4. /
5. bpez/infuse

ActiveLibrary[Admin Panels](/categories/admin)

bpez/infuse
===========

Infuse is a laravel admin package for generating administration style interfaces

v5.5.24(8y ago)25.3kMITCSSPHP >=5.4.0

Since Dec 9Pushed 8y ago1 watchersCompare

[ Source](https://github.com/ljgpartners/infuse)[ Packagist](https://packagist.org/packages/bpez/infuse)[ RSS](/packages/bpez-infuse/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependencies (14)Versions (50)Used By (0)

Infuse
======

[](#infuse)

[![Latest Stable Version](https://camo.githubusercontent.com/9f1b1054edd6f642e2e4315eed7a55fd2f44e841b1ccbba5094fe930bdb6b821/68747470733a2f2f706f7365722e707567782e6f72672f6270657a2f696e667573652f762f737461626c652e706e67)](https://packagist.org/packages/bpez/infuse) [![Total Downloads](https://camo.githubusercontent.com/8221e25c1140687a45b1297512c10a4f7e340258574389a51002e51d7289832f/68747470733a2f2f706f7365722e707567782e6f72672f6270657a2f696e667573652f646f776e6c6f6164732e706e67)](https://packagist.org/packages/bpez/infuse) [![Latest Unstable Version](https://camo.githubusercontent.com/898dd52c5de63abc4829a6722f366fa78fc5c1bfbe4f5c5589fdea6ca37a3699/68747470733a2f2f706f7365722e707567782e6f72672f6270657a2f696e667573652f762f756e737461626c652e706e67)](https://packagist.org/packages/bpez/infuse) [![License](https://camo.githubusercontent.com/9fdf2eed82476e67ef015c9c236597846a75fb5f738fc972a12c13780164fae7/68747470733a2f2f706f7365722e707567782e6f72672f6270657a2f696e667573652f6c6963656e73652e706e67)](https://packagist.org/packages/bpez/infuse)

Setup
-----

[](#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

[](#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

[](#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

[](#behat-infuse-test-suite)

```
imports:
  - vendor/bpez/infuse/behat.yml

```

### High level data flow

[](#high-level-data-flow)

```
model(mapConifig -> getbModelInstance(s) -> boot -> apiCalls) -> process(route -> renderView)
```

Infuse Configuration API
========================

[](#infuse-configuration-api)

addSelect
---------

[](#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

[](#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
--------------

[](#describecolumn)

Adds a description to a database field.

```
describeColumn(array(
    array(
        "column" => $columnName,
        "desc" => "description here",
        "popover" => true
    )
    ...
);
```

#### Parameters

[](#parameters-1)

- column - (Required) \[string\] Database table field name
- desc - (Required) \[string\] Description
- popover (Optional) \[boolean\] If option present then descript displayed as html pop.

onlyOne
-------

[](#onlyone)

Only allow one database entry to be display and created.

```
onlyOne();
```

addPermanentFilters
-------------------

[](#addpermanentfilters)

Add a SQL where clause to configuration.

```
addPermanentFilters(array(
    array(
        "column" => $columnName,
        "operator" => "=",
        "value" => 87
    )
    ...
);
```

#### Parameters

[](#parameters-2)

- 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
-------------------

[](#defaultcolumnvalues)

Add a default value for when an entry is saved.

```
defaultColumnValues(array(
    "column_name_1" => $value1,
    "column_name_2" => $value2,
    ...
);
```

#### Parameters

[](#parameters-3)

- array - (Required) \[array\] Array of default values where the index is the column name and the value is the value for the index

addMultiSelect
--------------

[](#addmultiselect)

Transform field to multiple select. Where IDs are kept track separated by a coma.

```
addMultiSelect(array(
    array(
        "column" => $columnName,
        "array" => array(),
    ),
    ...
);
```

#### Parameters

[](#parameters-4)

- 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
-------

[](#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

[](#parameters-5)

1. (Required) \[string\] Child model name
2. (Required) \[string\] Display name for entries listed on parent edit page
3. (Required) \[array\] Child columns to display on entries listed on parent edit page
4. (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
------------

[](#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

[](#parameters-6)

1. Database table field names

fileUpload
----------

[](#fileupload)

Configure columns for file upload functionality.

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

#### Parameters

[](#parameters-7)

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

addCkeditor
-----------

[](#addckeditor)

Turns a text field to a addCkeditor.

```
addCkeditor(
    array("column_name_1", "column_name_2", ...)
)
```

#### Parameters

[](#parameters-8)

- Database table field names

callFunction
------------

[](#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

[](#parameters-9)

1. (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
2. (Required) \[string\] Display name for the function
3. (Optional) \[string\] If its a lengthy process you can set a message that will populate a waiting modal while the process is running.
4. (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
--------------

[](#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

[](#parameters-10)

1. (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
2. (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
----------------

[](#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

[](#parameters-11)

1. (Required) \[string\] table field names

Eloquent ORM
============

[](#eloquent-orm)

Setup models to work with infuse by extending the InfuseModel and using InfuseModelLibrary trait.

```
class BlogPost extends InfuseModel {

	use InfuseModelLibrary;

}
```

### InfuseModel features

[](#infusemodel-features)

#### url($columnName, $hstoreColumn = false)

[](#urlcolumnname-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)

[](#thumborcolumnname-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.
2.

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

```

```

Bpez\\Infuse\\Util
==================

[](#bpezinfuseutil)

#### Util::thumbor($url)

[](#utilthumborurl)

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

```

```

#### Util::cdn($url)

[](#utilcdnurl)

For delivering assets originating from same origin through CloudFront CDN. Services configuration required please see service configuration below for setup.

```
Util::cdn($url);
```

Services
========

[](#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
====================

[](#retina-image-support)

Include the Util::infuse() on your page (put it at the bottom of your template, before your closing tag)

```
	{!! Util::infuse() !!}

```

S3 CORS needs to be enabled and config needed for retina support:

```

        *
        GET
         HEAD
        3000
        Authorization

'self-hosted' => 'http://d54343425.cloudfront.net',
],
```

Created with [http://dillinger.io](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

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity71

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 ~28 days

Recently: every ~61 days

Total

47

Last Release

3222d ago

Major Versions

1.0.0 → 2.0.02014-01-04

2.0.0 → v3.4.12014-11-18

v3.4.1 → v4.0.02015-02-11

v4.0.0 → v5.2.162015-06-22

PHP version history (2 changes)1.0.0PHP >=5.3.7

v3.4.1PHP >=5.4.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/bdca8ebb8dc721ad5148fe2f40ee78f3719f5e8745d7a14ffd6c1f4fcb75ad13?d=identicon)[perezjbryan](/maintainers/perezjbryan)

---

Top Contributors

[![78zepb](https://avatars.githubusercontent.com/u/34171752?v=4)](https://github.com/78zepb "78zepb (283 commits)")

---

Tags

laravelscaffoldlaravel 5admin

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bpez-infuse/health.svg)

```
[![Health](https://phpackages.com/badges/bpez-infuse/health.svg)](https://phpackages.com/packages/bpez-infuse)
```

###  Alternatives

[sebastienheyd/boilerplate

Laravel Boilerplate based on AdminLTE 3 with blade components, user management, roles, permissions, logs viewer, ...

28618.2k3](/packages/sebastienheyd-boilerplate)[weblabormx/laravel-front

Front is a administration panel for Laravel. It allows you to create CRUD easily in minutes. It allows to fully customize any part of the code.

1111.1k](/packages/weblabormx-laravel-front)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)