Описание

Plugin fix orphans position and replace space after orphan to hard space, to avoid line break incorrect position.

Orphan — a text composition error, which consists in leaving a lonely short word at the end or at the beginning of a verse, especially a single-character one. The word «lonely» here means separation from a closely related word by line breaks.

Asset image

Manuscript by Muffet, on Flickr

Скриншоты

Options for entries.
Options for widgets.
Options for taxonomies.
Miscellaneous options.

Установка

There are 3 ways to install this plugin:

The super easy way

Log in to your WordPress Admin panel.
Go to: Plugins > Add New.
Type ‘orphans’ into the Search Plugins field and hit Enter. Once found, you can view details such as the point release, rating and description.
Click Install Now. After clicking the link, you’ll be asked if you’re sure you want to install the plugin.
Click Yes, and WordPress completes the installation.
Activate the plugin.
A new menu Orphans in Appearance will appear in your Admin Menu.

The easy way

Download the plugin (.zip file) on the right column of this page.
In your Admin, go to menu Plugins > Add.
Select button Upload Plugin.
Upload the .zip file you just downloaded.
Activate the plugin.
A new menu Orphans in Appearance will appear in your Admin Menu.

The old and reliable way (FTP)

Upload sierotki folder to the /wp-content/plugins/ directory.
Activate the plugin through the ‘Plugins’ menu in WordPress.
A new menu Orphans in Appearance will appear in your Admin Menu.

Часто задаваемые вопросы

When this plugin replace spaces?

Plugin works when viewing the content and does not modify your content.

How to use this plugin on custom field?

Use this code:

if ( class_exists( 'iworks_orphan' ) ) {
    $orphan = new iworks_orphan();
    echo $orphan->replace( get_post_meta($post_id, 'meta_key', true ) );
}

How to use this plugin on any string?

Use this code:

if ( class_exists( 'iworks_orphan' ) ) {
    $orphan = new iworks_orphan();
    echo $orphan->replace( 'any_string' );
}

How to change plugin capability?

By default to use this plugin you must have manage_options capability, that usually mean site administrator. If you want to allow manage Orphans by «Editors» then you need to use other capability, e.g. unfiltered_html. You can use iworks_orphans_capability filter:

add_filter('iworks_orphans_capability', 'my_orphans_capability');
function my_orphans_capability($capability) {
    return 'unfiltered_html';
}

How to turn of replacement in my piece of code?

At the beginning of your block just add:

add_filter( 'orphan_skip_replacement', '__return_true' );

and at the end, to again turn on replacements:

remove_filter( 'orphan_skip_replacement', '__return_true' );

How can I change default orphans?

Please use iworks_orphan_terms filter. It is array of default orphans. You can remove, add or even replace whole array. For example, to remove words «oraz», «na» and «»nie», use code bellow:

add_filter( 'iworks_orphan_terms', 'remove_iworks_orphan_terms' );
function remove_iworks_orphan_terms( $terms ) {
    $default_orphans_to_remove = array( 'oraz', 'na', 'nie', );
    foreach( $default_orphans_to_remove as $value ) {
        if ( $key = array_search( $value, $terms ) ) {
            unset( $terms[ $key ] );
        }
    }
    return $terms;
}

Отзывы

adamwygnaniec 13.06.2022

Robi co trzeba. Super

benpl 25.05.2022

Autor pomyślał o wszystkim. Szczególnie cieszy bardzo łatwa możliwość wykluczenia zwrotów.

pnt 22.05.2022

Wszystko super, tylko nie spamujcie tyle w dashbordzie, raz wystarczy.

Adam Romanowski 31.03.2022

The plugin works as advertised. Also, it provides many options and filters. Impressive support by Marcin.

golashki 18.03.2022

Jeszcze raz dzięki 🙂

tulukaruk 10.03.2022

Nie da się zrobić polskiej stronki bez niego 🙂

Посмотреть все 148 отзывов

Участники и разработчики

«Orphans» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:

Marcin Pietrzak

«Orphans» переведён на 2 языка. Благодарим переводчиков за их работу.

Перевести «Orphans» на ваш язык.

Заинтересованы в разработке?

Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.

Журнал изменений

3.0.0 — 2022-04-21

Added Transients API to avoid multiple read from terms.txt file.
Removed unused method add_help_tab().

2.9.11 — 2022-04-05

Updated iWorks Options to 2.8.3. (Fixed PHP 7.x compatibility).

2.9.10 — 2022-04-05

Updated iWorks Options to 2.8.3.
Updated iWorks Rate to 2.1.0.

2.9.9 — 2022-03-29

Fixed missing filter usage for priority. Props for Adam Romanowski.

2.9.8 — 2022-02-05

Improved checking is plugin «Advanced Custom Fields» — removed usage of class_exists function.
Moved load_plugin_textdomain() function to allow load i18n even plugin is not active.

2.9.7 — 2022-02-05

Improved checking is plugin «Advanced Custom Fields» to avoid multiple calling function class_exists. Props for Piotr.
Remove duplicates from «terms to replace» list and sort this list.

2.9.6 — 2022-02-03

Added check for missing second param in the_title filter. Props for Zbyszek Zalewski

2.9.5 — 2022-02-02

Fixed missing replacements before and after any tag. Props for gierand.

2.9.4 — 2022-02-02

Added ability to turn off replacements on menu title elements. New option is in «Miscellaneous» tab.
Added orphan_allowed_filters to add ability to change allowed filters.
Fixed issue with Font Awesome replacements. Props for lewleo999
Improved replacement process to avoid change HTML tags params.

2.9.3 — 2022-01-20

Removed doubled «Donate» link on plugin page.
Updated iWorks Options to 2.8.0.

2.9.2 — 2022-01-19

Updated iWorks Options to 2.7.3.
Updated iWorks Rate to 2.0.6.

2.9.1 — 2021-12-09

Added integration with «Advanced Custom Fields» for fields types: «text», «textarea», «WYSIWYG». Props for Kamil Lipiński for the tests.

2.9.0 — 2021-12-09

Added filter iworks_orphan_own_terms_file to add ability to change whole terms definition file.
Moved terms into etc/terms.txt.
Renamed file includes/iworks/orphan.php into includes/iworks/class-iworks-orphan.php.
Updated orphans list, based on Sierotka (typografia)

2.8.2 — 2021-12-03

Fixed problem with option «Keep numbers together» — it changed inline CSS too. Props for gierand.

2.8.1 — 2021-11-26

Added a widget blocks content to replacements.
Added filter iworks_orphan_terms (old one has a typo iworks_orphan_therms — but old one stays too).
Improved filtering defaults orphans — now it is filtered when we get it, not only on init.

2.8.0 — 2021-08-31

Fixed conflict with some plugins. Props for Adam Gruntkowski.
Updated iWorks Rate to 2.0.4.
Updated WordPress Options Class to version 2.7.1.

2.7.9 — 2021-06-23

Renamed directory vendor into includes.
Updated iWorks Rate to 2.0.1.

2.7.8 — 2021-01-13

Added orphan_replace filter to add ability to force replacements on any string.
Turned off content filters for admin area — it could mess with another plugins. Props for Zbyszek Zalewski.

2.7.7 — 2020-06-20

Added orphan_skip_replacement filter to force skip replacements. Check FAQ to know how to use it.

2.7.6 — 2020-06-08

Turned off replacements in feeds.
Turned off replacements in REST API.

2.7.5 — 2019-11-12

Fixed default values configuration.
Handled quotation mark before orphan.
Moved orphan’s filters at the end of run, to try to avoid different plugins replacements.
Split replacement rules to avoid problem with regular expression is too large.
Updated WordPress Options Class to version 2.6.8

2.7.4 — 2018-03-16

Fixed problem with too greedy number replacement.

2.7.3 — 2018-03-15

Fixed problem with $post object. Props for adpawl
Fixed space after a number, but before a word. Props for M. Hawranek.
Fixed too early translation load, it causes sometimes missing translation.
Updated WordPress Options Class to version 2.6.5.

2.7.2 — 2018-02-13

Added html entities handling.
Added WooCommerce short description, which use they own filter.
Fixed problem with orphan directly after orphan.
Refactored input data.
Updated WordPress Options Class to version 2.6.4.

2.7.1 — 2017-12-22

Fixed a problem with array handling, when document contains scripts or styles.

2.7.0 — 2017-06-29

Added custom fields — now you can easily add custom field name to the configuration.
Added words: ‘albo’, ‘bez’, ‘czy’, ‘lecz’, ‘nie’, ‘niech’, ‘przez’, ‘tak’, ‘tylko’, ‘więc’ base on Sierotka

2.6.9 — 2017-05-24

Fixed a problem with class declaration. Props for gierand

2.6.8 — 2017-05-23

Added author description to replacements.
Added a taxonomies title and description to replacements.
Fixed a problem with preg_replace() «Compilation failed: range out of order».
Use WordPress Options Class to handle new options screen.

2.6.7 — 2017-05-09

Allow to apply replacement to all languages by using filter `iworks_orphan_apply_to_all_languages’ set on true.
Fixed rate module.

2.6.6.1 — 2017-04-30

Fixed wrong regexp replacement.

2.6.6 — 2017-04-30

Avoid to replace «script» and «styles» content. Props for m1nified
Added a widget title to replacements.
Added a widget text to replacements (it work only for the widget text).

2.6.5 — 2016-11-01

Rollback to 2.6.3, because 2.6.4 broke images.

2.6.4 — 2016-11-01

Added symbols, like FX-10, F-800, F-600-K3-Z. «-» is replaced by ‑ char. Props for Marcin

2.6.3 — 2016-10-25

Implement WP syntax rules for PHP files.
Added «Call for ratings» on settings page.

2.6.2 — 2016-02-27

Fixed a problem with ignored option for numbers. Props for Kacper
Added check site or entry language to avoid replacing if language is other then Polish. It is one exception: numbers.

2.6.1 — 2016-01-11

Fixed a problem with non-breakable space. Replace space after number to space between numbers.

2.6 — 2016-01-09

Change language domain from iworks_orphan to plugin name `sierotki’ to be compatible with i18n WordPress rules.
Added activate plugin hook to change options autoload status.
Added deactivate plugin hook to change options autoload status.
Added filter iworks_orphans_capability, Props for Cezary Buliszak.
Added non-breakable space after numbers.
Added uninstall plugin hook.
Update screenshots.

2.5 — 2015-11-06

IMPROVEMENT: added filter iworks_orphan_replace

2.4 — 2015-02-12

Added hard space between number (year) and polish year shortcut «r.»
Added WooCommerce product title and short description to available options. Props for Dominik Kawula

2.3.2 — 2014-09-12

Fixed error in options array

2.3.1 — 2014-09-12

Checked option array for non existing hash.
Обновлены скриншоты.

2.3 — 2014-07-10

IMPROVEMENT: added all forms of word number

2.2 — 2014-01-24

IMPROVEMENT:added links to forum
IMPROVEMENT:checked capability with WP 3.8

2.1 — 2013-11-09

IMPROVEMENT:checked capability with WP 3.6
REFACTORING: implement PSR-0 rules to orphan class

2.0.2 — 2013-08-20

BUGFIX: fixed replacement for single letter orphan after orphan. Props for Szymon Skulimowski
IMPROVEMENT:checked capability with WP 3.6
IMPROVEMENT:added help and related section

2.0.1 — 2013-07-10

IMPROVEMENT:added numbers

2.0 — 2012-08-12

BUGFIX: fixed permissions to configuration page
BUGFIX: fixed replacement for strings starting with a orphan
REFACTORING: rewrite code to the class
IMPROVEMENT:added some shorts of academic degree
IMPROVEMENT:massive increase orphans dictionary. Props for adpawl

1.4.2 — 2012-03-02

NEW: added the_title filter.

1.4.1 — 2011-02-24

NEW: Trim chars.
BUGFIX: Fixed multi coma use.

1.4 — 2011-02-24

NEW: Added user defined orphans.
BUGFIX: Corrected capability name.

1.3 — 2011-02-19

NEW: Added option page to turn on/off filtering in content, excerpt or comments.
NEW: Added «(» as char before a orphan.

1.2 — 2011-02-18

NEW: Added filter comment_text.
BUGFIX: Capital letters was missing by plugin.

1.1 — 2011-02-17

Abandoning elegant anonymous function, which requires PHP 5.3.0 🙁
NEW: Added filter to the_excerpt.

1.0.2 — 2011-02-17

NEW: Added «>» as char before a orphan.

1.0.1 — 2011-02-16

NEW: Added word «to».

1.0 — 2011-02-16

INIT