milqmedia/mq-util

Milq Media Utilities

mq-util

mq-util is deprecated. Please use another package with active development., _(*1)

Basic utillities used in ZF2 controller and views., _(*2)

Zend Framework 2 View helpers - less() to convert LESS files to CSS - js() to retrieve versioned js files - dateFormat() to format dates in different, many used, formats - percent() to quickly calculate a percentage, _(*3)

MQUtil\Collector\Milq, _(*4)

ZendDeveloperTools collector listing environment, timezone and defaultlocale, _(*5)

MQUtil\Log\Writer\Doctrine, _(*6)

Doctrine log writer, _(*7)

MQUtil\Service\ShortUrl, _(*8)

Url shortner using the Google urlshortener API., _(*9)

MQUtil\Service\Paginator, _(*10)

Super simple and easy to use pagination class, _(*11)

MQUtil\Service\Iterator, _(*12)

Super simple and easy to use iteration class with prevItem support, _(*13)

Installation

1. Run php composer.phar require milqmedia/mq-util:dev-master
2. Add MQUtil to the enabled modules list
3. Use the less or js viewhelper in your template

Usage

Less & JS helpers, _(*14)

$this->headLink()->setStylesheet($this->basePath($this->less('less/site.less')))
$this->headScript()->setFile({$this->basePath($this->js('jquery')))

Percent view helper, _(*15)

$this->percent($total, $count, $reverse = false);

• $total: Total items
• $count: Items to calculate percentage of
• $reverse: Return the remaining percentage instead of the calculated percentage

DateFormat view helper, _(*16)

$this->dateFormat($date)->dayName();

Available methods: - forumDate: Returns "H:i" if today, "d-m H:i" if this year, else "d-m-y H:i" - ago: Returns seconds, minutes, hours, days, etc. ago since given date - dayName($short = false): Dayname for the given date, if short is true dayname is in a short format e.g. Sun. - monthName: Monthname for the given date, _(*17)

MQUtil\Collector\Milq, _(*18)

Add the collector to the zdt config file, _(*19)

array(
    'zenddevelopertools' => array(
        'profiler' => array(
            'collectors' => array('milq' => 'MQUtil\Collector\Milq'),
        ),
    )

And a template to the toolbar, _(*20)

array(
    'zenddevelopertools' => array(
        'toolbar' => array(
          'entries'       => array(
              'milq' => 'zend-developer-tools/toolbar/milq',
            ),
          )
       )
)

MQUtil\Log\Writer\Doctrine, _(*21)

Copy the Log.php.dist file from the package root to your entity directory. Change the namespace if necessary., _(*22)

Use it like this:, _(*23)

$this->getServiceLocator()->get('Zend\Log\Logger')->err("error")

MQUtil\Service\ShortUrl, _(*24)

Configure your Google API Key:, _(*25)

return array(
    'google_short_url' => array(
        'apiKey' => '<key>',
    )
);

Use it like this:, _(*26)

$shortUrlApi = $this->getServiceLocator()->get('MQUtil\Service\ShortUrl');
$response = $shortUrlApi->shortenUrl('http://google.com');

If successful, the response will look like:, _(*27)

{
 "kind": "urlshortener#url",
 "id": "http://goo.gl/fbsS",
 "longUrl": "http://www.google.com/"
}

MQUtil\Service\Paginator, _(*28)

Create a new pagination object:, _(*29)

$paginator = $this->getServiceLocator()->get('MQUtil\Service\Paginator')->getPaginator($numberOfItems, $numberOfItemsPerPage, $currentPage);

Available methods:, _(*30)

$paginator->next();
$paginator->prev();
$paginator->current();
$paginator->total();
$paginator->offsetStart();
$paginator->isLastPage();

MQUtil\Service\Iterator, _(*31)

Create a new iteration object:, _(*32)

$iterator = $this->getServiceLocator()->get('MQUtil\Service\Iterator')->getIterator($array, $currentItem);

Available methods:, _(*33)

$iterator->hasNext();
$iterator->nextItem();
$iterator->hasPrev();
$iterator->prevItem();
$iterator->currentItem();
$iterator->isLastItem();

Development

..., _(*34)

Contributing

1. Fork it ( https://github.com/milqmedia/mq-util/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request