chub / timelinejs-bundle
TimelineJS bundle for Symfony2
Installs: 19
Dependents: 0
Suggesters: 0
Security: 0
Stars: 6
Watchers: 4
Forks: 4
Open Issues: 0
Type:symfony-bundle
Requires
- php: >=5.3.3
- symfony/framework-bundle: 2.2.*
- symfony/yaml: 2.2.*
This package is not auto-updated.
Last update: 2024-11-09 14:04:06 UTC
README
TimelineJS Symfony2 bundle. Provides easy integration of TimelineJS.
About TimelineJS
There are lots of timeline tools on the web but they are almost all either hard on the eyes or hard to use. Create timelines that are at the same time beautiful and intuitive for users.
Installation
Download bundle
First of all, download bundle using one of common ways:
Using deps file
Add the following lines to your deps
file and run php bin/vendors install
[TimelineJSBundle]
git=https://github.com/ChubV/TimelineJSBundle.git
target=bundles/ChubProduction/TimelineJSBundle
Using composer
Register the namespaces
Add the following namespace entry to the registerNamespaces
call
in your autoloader:
<?php // app/autoload.php $loader->registerNamespaces(array( // ... 'ChubProduction\TimelineJSBundle' => __DIR__.'/../vendor/bundles', // ... ));
This is unnecessary step if you use Composer's automaticaly generated autoload file
Register the bundle
To start using the bundle, register it in your Kernel:
<?php // app/AppKernel.php public function registerBundles() { $bundles = array( // ... new ChubProduction\TimelineJSBundle\TimelineJSBundle(), ); // ... }
Create your first Timeline
Create an entity that implements TimelineEntityInterface
<?php // TimelineEntity.php // ... class TimelineEntity implements TimelineEntityInterface { // ... }
Fetch an array of your entities
Array will represent the points on your Timeline. Create timeline and pass it to your view.
<?php // TimelineController.php // ... /** * @Route("/timeline", name="_timeline") * @Template() */ public function timelineAction() { $ts = $this->get('timelinejs'); $timeline = $ts->createTimeline('myTimeline', $this->fetchTimelineEntities()); return compact('timeline'); }
Render timeline in your template
{# timeline.html.twig #} {% import "TimelineJSBundle::macro.html.twig" as t %} {{ t.head() }} <div id="timeline"></div> {{ t.show(timeline, {'embed_id': 'timeline', 'debug': true}) }}