Generate Initial based icons with a colored background similar to Gmail's
PHP
Pull request Compare This branch is 28 commits ahead, 101 commits behind yzalis:master.
Latest commit f7dcb69 Nov 22, 2015 @tomschlick tomschlick remove hipchat
Permalink
Failed to load latest commit information.
doc
src
tests/Initialcon/Tests fixing test examples Jul 20, 2015
.gitignore
.travis.yml
LICENSE
README.md
composer.json
phpunit.xml.dist Hello Initialcons! May 26, 2014

README.md

Initial based icon generator for PHP

Build Status StyleCI Latest Stable Version Total Downloads Latest Unstable Version License

Initialcon example #1   Initialcon example #2   Initialcon example #3  

Installation

The recommended way to install Initialcon is through composer.

Just create a composer.json file for your project:

{
    "require": {
        "runmybusiness/initialcon": "*"
    }
}

And run these two commands to install it:

$ wget http://getcomposer.org/composer.phar
$ php composer.phar install

Now you can add the autoloader (if your framework doesn't already do this for you), and you will have access to the library:

<?php

require 'vendor/autoload.php';

You're done.

Usage

Images are generated in PNG format with a colored background & the initials in white text.

The string can be an email, an IP address, a username, an ID or something else that is persistant between page loads. This string determines the color of the icon background and will persist between pageloads so long as the string doesnt change.

Generate an initialcon

Create a new Initialcon object.

$initialcon = new Initialcon();

Then you can generate and display an initialcon image

$initialcon->displayImage('TS', 'tom@test.com');

or generate and get the image data

$imageData = $initialcon->getImageData('TS', 'tom@test.com');

or generate and get the base 64 image uri ready for integrate into an HTML img tag.

$imageDataUri = $initialcon->getImageDataUri('HI', 'hello@test.com');
<img src="<?php echo $imageDataUri; ?>" alt="bar Initialcon" />

Change the size

By default the size will be 64 pixels. If you want to change the image size just add a secondary parameter. 512 x 512px in this example.

$initialcon->displayImage('TS', 'tom@test.com', 512);

Color

The color is automaticaly generated according to the string hash but you can chose to specify a color by adding a third argument.

Color can be an hexadecimal with 6 characters

$initialcon->displayImage('TS', 'tom@test.com', 64, 'A87EDF');

Image Object

You can also grab the Image object to add more manipulation to the final icon (such as rounded corders, opacity, etc). We use the Intervention library for image creation so all of its' methods are available to you.

$initialcon->getImageObject('TS', 'tom@test.com', 512);

That's it!

Unit Tests

To run unit tests, you'll need and a set of dependencies you can install using Composer:

php composer.phar install

Once installed, just launch the following command:

phpunit

Everythings should be ok.

Credits

License

Initialcon is released under the MIT License. See the bundled LICENSE file for details.