swisnl / textsnippet
Create a snippet of text highlighting a given string
Installs: 3 501
Dependents: 1
Suggesters: 0
Security: 0
Stars: 14
Watchers: 7
Forks: 1
Open Issues: 2
Requires
- php: >=7.1
Requires (Dev)
- phpstan/phpstan: ^0.12.18
- phpstan/phpstan-nette: ^0.12.6
- phpunit/phpunit: ~6.0
- tracy/tracy: ^2.7
This package is auto-updated.
Last update: 2024-11-07 19:23:54 UTC
README
Easy and fast way to create a snippet of text, for example for a search result. It will try and highlight the given words and give you the relevant text around it.
Installation
Just use composer to install the package. Or download and include the TextSnipet.php
file.
composer require swisnl/textsnippet
Examples
Some examples based on a 3 paragraph long Lorum ipsum text.
Basic usage
$snippet = new TextSnippet() $snippet->createSnippet('Lorem', $lorumIpsum);
Will result in:
Lorem ipsum dolor sit amet, consectetur adipiscing elit. ... Etiam bibendum lorem nec tempus sollicitudin. ... Sed in dapibus lorem. ... Nunc turpis ipsum, bibendum quis sodales sed, ullamcorper et lorem. Donec et metus hendrerit, interdum elit ut, dignissim dui.
Setting highlight html
You can set the tags surrounding the highlighted text. The %word%
tag is required.
$snippet = new TextSnippet() $snippet->setHighlightTemplate('<strong>%word%</strong>')
Setting min and max words
Setting min and maxwords tells the class to try and keep the number of words between the min and max.
// Defaults $minWords = 30; $maxWords = 100;
Setting min and max words.
$snippet = new TextSnippet() $snippet->setMinWords(10); $snippet->setMaxWords(30);
There is a known issue if you set min and max very close to eachother. It might not find the correct set of words/sentences to get exactly between the small gap.
Licence
The MIT License (MIT). Please see License File for more information.
This package is Treeware. If you use it in production, then we ask that you buy the world a tree to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.
SWIS ❤️ Open Source
SWIS is a web agency from Leiden, the Netherlands. We love working with open source software.