Download the PHP package caouecs/sirtrevorjs without Composer

Laravel-SirTrevorJS

Integrate the tool Sir Trevor JS in a Laravel 5/6/7/8/9 project.

Installation

This package is available through Packagist and Composer.

For PHP 8 version, use the branch master : "caouecs/sirtrevorjs": "~4.1.0"

For PHP 7 version, use the branch v3.0 : "caouecs/sirtrevorjs": "~3.0.0"

For Laravel >= 5.2 version parser, use the branch v2.5 : "caouecs/sirtrevorjs": "~2.5.0"

For Laravel >= 5.1 version js & amp, use the branch v2.4 : "caouecs/sirtrevorjs": "~2.4.0"

For Laravel >= 5.1 version fb articles, use the branch v2.3 : "caouecs/sirtrevorjs": "~2.3.0"

For Laravel >= 5.1 version view & amp, use the branch v2.2 : "caouecs/sirtrevorjs": "~2.2.0"

For Laravel >= 5.1 version base, use the branch v2.1 : "caouecs/sirtrevorjs": "~2.1.0"

For Laravel 5.0, use the branch v2 : "caouecs/sirtrevorjs": "~2.0.0"

For Laravel 4, use the branch laravel4 : "caouecs/sirtrevorjs": "~1.4"

Please read README.md in the choosen branch.

Service Provider

If you want to use routing, controllers, views, binding directly in your project, in your app/config/app.php, add "Caouecs\Sirtrevorjs\SirtrevorjsServiceProvider" to your list of providers.

Twitter

To get tweets, this project uses thujohn/twitter. Please visit the page of the project to know how to install and configure.

Configuration file

Next, you must migrate config :

php artisan vendor:publish caouecs/sirtrevorjs

After installation, the config file is located at app/config/packages/caouecs/sirtrevorjs/sir-trevor-js.php.

You can define :

• the path for image upload
• the route for upload image
• the route for tweet
• the path of Sir Trevor files
• the list of block types
• custom blocks
• the language
• the paths for Eventable.js and Underscore.js
• the view
• configuration for blocks
  • soundcloud
  • gettyimages
• etc...

SirTrevorJs class

Assets

For stylesheets :

For scripts, in your Blade files :

Fix for image block

Function to fix a problem with image block when you add a new image :

Find first image

Get first image in text with findImage method :

In return, you have url of image or empty string.

Find elements by blocktypes

Get all elements in text, in specified blocktype with find method :

In return, you can have :

• array, if you choose "array" for $output
• json, if you choose "json" for $output
• false, if the script doesn't find an occurence of blocktype

Controller

SirTrevorJsable

This trait proposes two things :

• upload image where you want
• get tweets

Upload image

This project proposes a system for upload image, nothing to configure, just the directory_upload value in config file.

Tweet

This project proposes a system to get tweets. I use thujohn/twitter project.

SirTrevorJsConverter class

This class need a parser, a configuration and a view by default.

You can use the binding of this class :

Html

Convert text from Sir Trevor Js to html :

These methods return a string with html and js codes.

Amp

Convert text from Sir Trevor Js to Amp:

All modules have an amp's version, if it exists an equivalence.

This method returns an array ( text and js).

Facebook Instant Articles

Convert text from Sir Trevor Js to Facebook Instant Articles:

All modules have an FBArticles's version, if it exists an equivalence.

This method returns a string with html and js codes.

Adding custom blocks

You can choose to add custom blocks in config file or add them by extending SirTrevorJsConverter class.

config

SirTrevorConverter

And you need to call this class in your service provider, in register :

$this->app->bind('editor.converter', function ($app) {
    return new App\SirTrevorConverters\SirTrevorJsConverterEditor(
        new LaravelParser(),
        config('sir-trevor-js'),
        'html'
    );
});

Modules

For the moment, the code can convert :

• blockquote / quote
• embedly card
• facebook post
• getty images
• heading
• iframe
• image
  • basic version
  • version with caption
• issuu
• pinterest
• sketchfab
• slideshare
• soundcloud
• spotify
• text with Markdown
• tweet
• unordered list
• video
  • aol
  • canal plus
  • daily mail uk
  • dailymotion
  • france tv
  • global news
  • livestream
  • metacafe
  • metatube
  • mlb
  • nbc bay area
  • nhl
  • ooyala
  • redtube
  • ustream (live and recorded)
  • veoh
  • vevo
  • vimeo
  • vine
  • wat
  • yahoo
  • youtube
  • zoomin.tv
  • video with caption