Описание
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
Установка
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
inAppearance
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
inAppearance
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
inAppearance
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 useiworks_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; }
Отзывы
Участники и разработчики
«Orphans» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:
Участники«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
intoincludes/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 typoiworks_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
intoincludes
. - 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