ahlsunnah/arabic-expressions

This WordPress plugin adds KFGQPC Arabic Symbols to WordPress and provides a simple way to add the expressions to you posts and pages.


Keywords
wordpress, arabic expressions, arabic symbols, islamic expressions, islamic symbols
Licenses
GPL-2.0/GPL-3.0+

Documentation

Arabic Expressions

بسم الله الرحمن الرحيم

Description

This WordPress plugin adds KFGQPC Arabic Symbols to WordPress and provides a simple way to add the expressions to you posts and pages.

How to use ?

Just insert the keyword of the arabic expression that you want in your post or page and enjoy !

Example : bs3

The Available expressions can be viewed in the Screenshots section.

Notes

  • Expression keyword must be surrounded with spaces characters; e.g. the expression keyword in -sallallahu3alayh- won't be replaced.
  • Expressions keywords won't be replaced in HTML tags nor inside of <pre> or <code> blocks.

This plugin is a fork of Font Emoticons

Licenses

Arabic Expressions: GPLv2 or later

KFGQPC Arabic expressions: Copyright (C) 2015 All right reserved to King Fahd Complex For Printing of The Holy Qur'an

The fonts are generated from KFGQPC Arabic Symbols font that belong to King Fahd Complex For Printing of The Holy Qur'an of Madinah in Saudi Arabia. It is downloadable freely on their website. The screenshots are also taken from their website.

Installation

Manual Installation

  1. Upload the arabic-expressions directory to the /wp-content/plugins/ directory
  2. Activate the plugin through the 'Plugins' menu in WordPress

Composer Installation

If you are using composer as a package manager you can install using :

  1. composer require ahlsunnah/arabic-expressions
  2. Activate the plugin through the 'Plugins' menu in WordPress or if you are using wp-cli : wp plugin activate arabic-expressions

Frequently Asked Questions

Arabic Expressions don't parse the keywords in some place my Theme/Plugin

Arabic Expressions are supported in most places where user defined text is displayed. However, there may be places in a plugin or theme that are not supported by Arabic Expressions.

In these cases, just apply the filter arabic_expressions_replace to the text that should display Arabic Expressions.

For example, you would change the following PHP code:

<?php echo get_the_author_meta( 'description' ); ?>

to this code:

<?php echo apply_filters('arabic_expressions_replace', get_the_author_meta( 'description' )); ?>

I have a problem with capital letter expressions, it doesn't work

You should look in the source code of your page if the DOCTYPE is correct. It is due to the use of capital letters in our CSS class names; if your DOCTYPE is incorrect, all browser behave like case-insensitive when using CSS class. See : http://stackoverflow.com/a/28556035/1673761

I have another problem

If you have a problem, please drop an issue in GitHub

I want to help

You can :

Screenshots

n keyword text screenshots
1 -bs1- بسم الله الرحمن الرحيم بسم الله الرحمن الرحيم
2 -bs2- بسم الله الرحمن الرحيم بسم الله الرحمن الرحيم
3 -bs3- بسم الله الرحمن الرحيم بسم الله الرحمن الرحيم
4 -asmaullah- أسماء الله الحسنى أسماء الله الحسنى
5 -lj- الله الله
6 -tamma- تم بحمد الله تم بحمد الله
7 -qr- قرآن كريم قرآن كريم
8 -Aa- الله أكبر الله أكبر
9 -Jj- جل جلاله جل جلاله
10 -Ja- جل وعلا جل وعلا
11 -Az- عز وجل عز وجل
12 -St- سبحانه وتعالى سبحانه وتعالى
13 -Tt- تبارك وتعالى تبارك وتعالى
14 -Sawaws- صلى الله عليه وعلى آله وسلم صلى الله عليه وعلى آله وسلم
15 -Saws- صلى الله عليه وسلم صلى الله عليه وسلم
16 -Rau- رضي الله عنه رضي الله عنه
17 -Raa- رضي الله عنها رضي الله عنها
18 -Raun- رضي الله عنهن رضي الله عنهن
19 -Rauma- رضي الله عنهما رضي الله عنهما
20 -Raum- رضي الله عنهم رضي الله عنهم
21 -Awasws- عليه وعلى آله الصلاة والسلام عليه وعلى آله الصلاة والسلام
22 -Asws- عليه الصلاة والسلام عليه الصلاة والسلام
23 -Aas- عليها السلام عليها السلام
24 -Aims- عليهم السلام عليهم السلام
25 -Aimas- عليهما السلام عليهما السلام
26 -As- عليه السلام عليه السلام
27 -Ra- رحمها الله رحمها الله
28 -Run- رحمهن الله رحمهن الله
29 -Ru- رحمه الله رحمه الله
30 -Ruma- رحمهما الله رحمهما الله
31 -Rum- رحمهم الله رحمهم الله
32 -muqaddimah- مقدمة مقدمة
33 -fihris- فهرس فهرس
34 -fasl- الفصل الفصل
35 -tamhid- تمهيد تمهيد
36 -tammat- تمت تمت
37 -bab- الباب الباب
38 -juz- الجزء الجزء
39 -tahanina- تهانينا تهانينا
40 -aa- الله أكبر الله أكبر
41 -az- عز وجل عز وجل
42 -st- سبحانه وتعالى سبحانه وتعالى
43 -jj- جل جلاله جل جلاله
44 -ja- جل وعلا جل وعلا
45 -tt- تبارك وتعالى تبارك وتعالى
46 -saws- صلى الله عليه وسلم صلى الله عليه وسلم
47 -rau- رضي الله عنه رضي الله عنه
48 -raa- رضي الله عنها رضي الله عنها
49 -raum- رضي الله عنهم رضي الله عنهم
50 -rauma- رضي الله عنهما رضي الله عنهما
51 -raun- رضي الله عنهن رضي الله عنهن
52 -asws- عليه الصلاة والسلام عليه الصلاة والسلام
53 -as- عليه السلام عليه السلام
54 -aas- عليها السلام عليها السلام
55 -aims- عليهم السلام عليهم السلام
56 -aimas- عليهما السلام عليهما السلام
57 -ru- رحمه الله رحمه الله
58 -rum- رحمهم الله رحمهم الله
59 -ruma- رحمهما الله رحمهما الله
60 -ra- رحمها الله رحمها الله
61 -run- رحمهن الله رحمهن الله
62 -7izb- الحزب الحزب
63 -rubu3- الربع الربع
64 -thumun- الثمن الثمن
65 -sabt- السبت السبت
66 -a7ad- الأحد الأحد
67 -ithnayn- الاثنين الاثنين
68 -thulatha- الثلاثاء الثلاثاء
69 -arba3a- الأربعاء الأربعاء
70 -khamis- الخميس الخميس
71 -jumu3a- الجمعة الجمعة
72 -mu7arram- محرم محرم
73 -safar- صفر صفر
74 -rabi31- ربيع الأول ربيع الأول
75 -rabi32- ربيع الثاني ربيع الثاني
76 -jumada1- جمادى الأولى جمادى الأولى
77 -jumada2- جمادى الآخرة جمادى الآخرة
78 -rajab- رجب رجب
79 -cha3ban- شعبان شعبان
80 -ramadan- رمضان رمضان
81 -chawal- شوال شوال
82 -dhulqa3da- ذو القعدة ذو القعدة
83 -dhul7jja- ذو الحجة ذو الحجة
84 -3idmubarak- عيد مبارك عيد مبارك
85 -3idsa3id- عيد سعيد عيد سعيد
86 -mu7tawiyat- المحتويات المحتويات

Changelog

2.2

  • Changed keywords of symbols. Sorry it breaks the texts mades with previous versions. You will have to update everything manually.
    • Changed keywords to be abreviations (shorter for quicker typing)
    • Changed symbol class names to match the new kewords
    • Changed the keywords to be surrounded by "-" to make it more generic.
  • Added a TODO file
  • Renamed screenshots

2.1.2

  • Removed screenshots from repository to make the package lighter

2.1.1

  • Some fixes for composer.json
  • readme changes

2.1.0

  • Changed plugin name to Arabic Expressions
  • Changed files names, functions names, variables and texts from arabic symbols to arabic expressions
  • Added readme.md for GitHub + included screenshots
  • Some changes to readme

2.0.0

  • First release of Arabic Symbols. It is a fork of the plugin Font Emoticons version 1.4.1.
  • Changes in this first release :
    • Replaced Font Emoticons's fonts and css files by KFGQPC Arabic Symbols font generated with Fontello
    • Changed plugin name, files names, functions names, variables and texts from font emoticon to arabic symbols
    • Changed symbols keywords names
    • Remove unused code
    • Add composer.json to make it available for installation with composer as a WordPress plugin
    • Added text license to the project
    • Modified readme.txt intensively

1.4.1

  • Feature: Added general purpose filter called wp_font_emots_replace. This filter can be used to replace emoticons in places not supported by this plugin.

1.4.0

  • Feature: Implemented rudimentary bbpress support. I don't use bbpress, so some parts may still no display emoticons correctly. (issue #10)
  • Feature: Emoticons are now also replace in the text sidebar widget.
  • Fix: emoticons.css no longer gets an unnecessary ?v= parameter attached (Wordpress does this automatically on its own); also made the style's name more unique so that it's less likely to conflict with other plugins.
  • Fix: Replaced usage of internal constant WP_PLUGIN_URL with plugins_url()

1.3.1

  • Fix: Self closing span (<span/>) seems to be invalid in some cases. Replaced it with regular <span></span> (issue #8)

1.3

  • Feature: New emoticon "squint": |) or :squint:
  • Feature: Added some general purpose icons like <3 (heart) or :thumbsdown: (:thumbsup: got changed to icon from emoticon)
  • Change: PHP 5.3 is now required
  • Change: "devil" and "eek" got more text representations; "smile" now also supports the Australian version (-:
  • Change: Made font and css classes more unique so that they don't interfer with other icon fonts (issue #7)
  • Fix: Multiple consecutive emoticons are now parsed correctly (issue #5); emoticons surrounded by HTML tags (like <li>:)</li>) are now parsed correctly.
  • Fix: Wider emoticons now flow correctly with surrounding text (no longer overlap it) (issue #4)

1.2

  • Emoticons are now supported in comments and excerpts. (issue #1)

1.1

  • Emoticons are no longer replaced in URLs. Instead they now require surrounding white space.
  • Emoticons at the beginning and the end of posts are recognized now.

1.0

  • First release.