2017 © Pedro Peláez
 

plugin wysiwygpreprocessor

A PHP library for processing wysiwyg/textarea output.

image

akibatech/wysiwygpreprocessor

A PHP library for processing wysiwyg/textarea output.

  • Tuesday, March 7, 2017
  • by MarceauKa
  • Repository
  • 1 Watchers
  • 6 Stars
  • 20 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 2 Forks
  • 0 Open issues
  • 9 Versions
  • 0 % Grown

The README.md

WYSIWYG Preprocessor

Build Status, (*1)

WYSIWYG Preprocessor is a PHP library with no dependencies. It's a sort of toolbox for processing your HTML textareas., (*2)

Installation

Sources are managed with Composer., (*3)

composer require akibatech/wysiwygpreprocessor "0.*"

Basic usage

For the given textarea,, (*4)

$textarea = "Check my website http://website.com. Keep in touch at hello@website.com !";

We want to transform the link and the email adress to HTML tags, (*5)

use Akibatech\Wysiwyg\Processor;  
use Akibatech\Wysiwyg\Modifier;  

$processor = new Processor();  

$processor->addModifier(new Modifier\UrlToLink)  
          ->addModifier(new Modifier\MailToLink)  
          ->process($textarea);  

echo $processor->getOutput();

Results in :, (*6)

Check my website <a href="http://website.com">http://website.com</a>. Keep in touch at <a href="mailto:hello@website.com">hello@website.com</a> !

Customizing modifiers

Modifiers are easily customizable.
Imagine you want to target all links to a new page or adding to it a custom class., (*7)

$textarea = 'Check out my new site: personnal-website.com';

$modifier = new Akibatech\Wysiwyg\Modifier\UrlToLink();

$modifier->setOptions([
    'class' => 'custom-link',
    'target' => '_blank'
])

$processor = new Akibatech\Wysiwyg\Processor();

$processor->addModifier($modifier)
          ->process($textarea);

echo $processor->getOutput();

Results in :, (*8)

Check out my new site: <a href="personnal-website.com" class="custom-link" target="_blank">personnal-website.com</a>

Modifiers

BBCode

Class: Akibatech\Wysiwyg\Modifier\BbCode
Description: Apply a basic BBCode to enhance your content., (*9)

Example input: [b]Hello[/b]
Example output: <strong>Hello</strong>, (*10)

Options:
Defaults tags are: b, i, u, left, right, center, quote, link, img, size and color.
Options are wilcard BBCode tag. Key is the wanted BBCode tag and option is the HTML replacement.
If pattern is given as array, it can access Tag option like [link=http://github.com]my profile[/link] as <a href="$1">$2</a>., (*11)

[  
    // New tag called [yellow]text in yellow[/yellow]  
    'yellow' => '<span style="color: yellow;">$1</span>',  
    // Disable default "b" tag  
    'b' => null  
]

Parse Variables

Class: Akibatech\Wysiwyg\Modifier\ParseVariables
Description: Replace a preset of variables., (*12)

Example input: Hello %name%!
Example output: Hello John!, (*13)

Options:
You can specify the delimiter and the accepted variables., (*14)

[  
    // My custom delimiter. Vars are parsed in this delimiter. Default is "%".  
    'in' => '%',  
    // Accepted vars
    'accept' => [
        'name' => 'Joe', // %name% => Joe
        'email' => 'email@example.com' // %email% => email@example.com
    ]
]

Absolute Path

Class: Akibatech\Wysiwyg\Modifier\AbsolutePath
Description: Will replace "href" and "src" attributes with absolute values., (*15)

Example input: <img src="../../files/sea.jpg" />
Example output: <img src="/files/sea.jpg" />, (*16)

Options:
You can specify a custom prefix for your paths., (*17)

[  
    // Custom prefix. Default is '/'.  
    'prefix' => 'http://site.com/', // <img src="http://site.com/files/sea.jpg" />
]

Words Filter

Class: Akibatech\Wysiwyg\Modifier\WordsFilter
Description: Remove a words list from a text. Act as a censorship system., (*18)

Example input: Cunt!
Example output: [censored]!, (*19)

Options:
The list and the replacement., (*20)

[  
    // Words list as an array.  
    'words' => ['word1', 'word2'], // No defaults words.
    // Replacement
    'replace' => '[censored]' // Wanted replacement, default to [censored]
]

Empty Paragraphs

Class: Akibatech\Wysiwyg\Modifier\EmptyParagraphs
Description: Delete empty paragraphs from your content., (*21)

Example input: <p></p><p>Hello</p><p>&nbsp;</p>
Example output: <p>Hello</p>, (*22)

Options:
None., (*23)

Class: Akibatech\Wysiwyg\Modifier\MailToLink
Description: Transforms emails adresses in clickable link tag., (*24)

Example input: email@company.com
Example output: <a href="mailto:email@company.com">email@company.com</a>, (*25)

Options:, (*26)

[  
    // Will replace "@" by "<at>", set to false to disable...  
    'at' => '<at>',  
]

NlToBr

Class: Akibatech\Wysiwyg\Modifier\NlToBr
Description: Replace line breaks into HTML line breaks. Similar to php native function nl2br()., (*27)

Example input: hello world
Example output: hello<br>world, (*28)

Options:, (*29)

[  
    // Linebreak symbol to search. Defaults to "\n"  
    'search' => "\n",  
    // HTML to replace. Defaults to "<br>"  
    'replace' => '<br />'  
]

StripTags

Class: Akibatech\Wysiwyg\Modifier\StripTags
Description: Remove HTML tags from input. Similar to php native function strip_tags()., (*30)

Example input: <p>hello world</p>
Example output: hello world, (*31)

Options:, (*32)

[  
    // Allowed HTML tags (see strip_tags documentation). Defaults, none.  
    'allow' => "<a>",  
]

Class: Akibatech\Wysiwyg\Modifier\UrlToLink
Description: Transforms web adresses in clickable link tag., (*33)

Example input: https://www.github.com
Example output: <a href="https://www.github.com">https://www.github.com</a>, (*34)

Options:, (*35)

[  
    // Add a custom class to all generated tags. No defaults.    
    'class' => 'link',  
    // Customize the link target. No defaults.  
    'target' => '_blank'  
]

Class: Akibatech\Wysiwyg\Modifier\YoutubeLinkToIframe
Description: Transforms youtube links (long and shorts) to a embed video player (iframe)., (*36)

Example input: My new video: https://youtu.be/wBqM2ytqHY4
Example output: My new video: <iframe src="https://www.youtube.com/embed/wBqM2ytqHY4?controls=1&rel=0&showinfo=1" class="youtube-iframe" width="560" height="315" frameborder="0" allowfullscreen></iframe>, (*37)

Options:, (*38)

[
    // Custom class added to the player
    'class'  => 'youtube-iframe',
    // Custom width (in px) or null
    'width'  => 560,
    // Custom height (in px) or null
    'height' => 315,
    // Allow fullscreen
    'allow_fullscreen' => true,
    // Enable youtube suggestions when video ends
    'with_suggestions' => false,
    // Display video info
    'with_infos' => true,
    // Display video controls
    'with_controls' => true
]

Your own modifiers

You can easily extends the preprocessor by adding your own modifiers.
All you need is to create a class implementing ModifierInterface. You're also encouraged to extends AbstractModifier to access common methods (setOptions, getOptions, ...)., (*39)

Basically, a modifier receive the input to transform through a public method handle($input).
Options are handled by a public method defaultOptions() returning an array of available options. And in your modifier body, you can access these options with the instance attribute options., (*40)

Callable modifier

You also have the possibility to add a dynamic modifier.
The method "addModifier" also accepts a callback function., (*41)

Example :, (*42)

$processor->addModifier(function($input) {
    return str_rot13('hello'); // Will return "uryyb"
});

Unit Tests

WYSIWYG Preprocessor is tested with PHPUnit.
Make sure you have composer dev dependencies installed and type :, (*43)

vendor/bin/phpunit

Authors

Author: Marceau Casals and all contributors
Licence: MIT, (*44)

The Versions

07/03 2017

dev-master

9999999-dev

A PHP library for processing wysiwyg/textarea output.

  Sources   Download

MIT

The Requires

  • php >=5.6

 

The Development Requires

by Avatar MarceauKa

plugin tags textarea bbcode link wysiwyg processor path

11/07 2016

0.0.8

0.0.8.0

A PHP library for processing wysiwyg/textarea output.

  Sources   Download

MIT

The Development Requires

by Avatar MarceauKa

plugin tags textarea bbcode link wysiwyg processor path

11/07 2016

0.0.7

0.0.7.0

A PHP library for processing wysiwyg/textarea output.

  Sources   Download

MIT

The Development Requires

by Avatar MarceauKa

plugin tags textarea bbcode link wysiwyg processor path

11/07 2016

0.0.6

0.0.6.0

A PHP library for processing wysiwyg/textarea output.

  Sources   Download

MIT

The Development Requires

by Avatar MarceauKa

plugin tags textarea bbcode link wysiwyg processor path

10/07 2016

0.0.5

0.0.5.0

A PHP library for processing wysiwyg/textarea output.

  Sources   Download

MIT

The Development Requires

by Avatar MarceauKa

plugin tags textarea bbcode link wysiwyg processor path

09/07 2016

0.0.4

0.0.4.0

A PHP library for processing wysiwyg/textarea output.

  Sources   Download

MIT

The Development Requires

by Avatar MarceauKa

plugin tags textarea bbcode link wysiwyg processor path

09/07 2016

0.0.3

0.0.3.0

A PHP library for processing wysiwyg/textarea output.

  Sources   Download

MIT

The Development Requires

by Avatar MarceauKa

09/07 2016

0.0.2

0.0.2.0

A PHP library for processing wysiwyg/textarea output.

  Sources   Download

MIT

The Development Requires

by Avatar MarceauKa

09/07 2016

0.0.1

0.0.1.0

A PHP library for processing wysiwyg/textarea output.

  Sources   Download

MIT

The Development Requires

by Avatar MarceauKa