EFAQ 6.1.5

= 6.1.5 =
* Abbreviation functions support added as `es(..)`, `at(..)`, `abh(..)`, `eh()`, `ej()`, `et()` for use mostly in templates, but they can also be used in models, if you use observer models that may be generating and returning to controller whole HTML blocks. Also these functions may be valuable for developers, that wants to have their HTML templates (or PHP-enhanced templates) be fully based only on SolidMVC (MIT-licensed), and not WordPress (GPL-licensed), as in this case your templates would be intensively calling only the MIT-licensed SolidMVC micro-framework’s functions. Additionally, this allows you to write a shorter code for your templates, which is easier to read for your designers.
* escBrHTML(..) support added for language interface.
* Minor documentation and code tune-up.

Author: kkMatt

ExpandableFAQ.php

@@ -3,7 +3,7 @@
  * Plugin Name: Expandable FAQ
  * Plugin URI: https://wordpress.org/plugins/expandable-faq/
  * Description: It’s a high quality, native and responsive WordPress plugin to create and view F.A.Q.'s
- * Version: 6.1.4
+ * Version: 6.1.5
  * Author: KestutisIT
  * Author URI: https://profiles.wordpress.org/KestutisIT
  * Text Domain: expandable-faq
@@ -43,7 +43,7 @@ final class ExpandableFAQ
         const REQUIRED_PHP_VERSION = '5.6.0';
         const REQUIRED_WP_VERSION = 4.6;
         const OLDEST_COMPATIBLE_PLUGIN_SEMVER = '6.0.0';
-        const PLUGIN_SEMVER = '6.1.4';
+        const PLUGIN_SEMVER = '6.1.5';
 
         // Settings
         /**

Models/Import/Demo.php

@@ -144,7 +144,7 @@ public function replaceContent()
                     // DEBUG
                     if($this->debugMode > 0)
                     {
-                        $debugMessage = "[DEMO] FAILED TO REPLACE IN PLUGIN TABLE: ".nl2br(esc_html($sqlQuery));
+                        $debugMessage = "[DEMO] FAILED TO REPLACE IN PLUGIN TABLE: ".esc_br_html($sqlQuery);
                         $this->debugMessages[] = $debugMessage;
                         //echo $debugMessage; // This class is used with redirect, do not output here
                     }

Models/Language/Language.php

@@ -190,6 +190,16 @@ public function escAttr($paramKey)
         return esc_attr($this->getText($paramKey));
     }
 
+    /**
+     * NOTE: Just an abbreviation method
+     * @param $paramKey
+     * @return string
+     */
+    public function escBrHTML($paramKey)
+    {
+        return esc_br_html($this->getText($paramKey));
+    }
+
     /**
      * NOTE: Just an abbreviation method
      * @param $paramKey

Models/Language/LanguageInterface.php

@@ -48,6 +48,13 @@ public function escSQL($paramKey);
      */
     public function escAttr($paramKey);
 
+    /**
+     * NOTE: Just an abbreviation method
+     * @param $paramKey
+     * @return string
+     */
+    public function escBrHTML($paramKey);
+
     /**
      * NOTE: Just an abbreviation method
      * @param $paramKey

Models/Update/Patches61Z.php

@@ -17,7 +17,7 @@ final class Patches61Z extends AbstractDatabase implements StackInterface, Datab
 {
     const CURRENT_MAJOR = 6; // Positive integer [X]
     const CURRENT_MINOR = 1; // Positive integer [Y]
-    const LATEST_PATCH = 4; // Positive integer [Z]
+    const LATEST_PATCH = 5; // Positive integer [Z]
     const LATEST_RELEASE = ''; // String
     const LATEST_BUILD_METADATA = ''; // String
     const PLUGIN_PREFIX = "expandable_faq_";

README.md

@@ -108,6 +108,11 @@ to your website's FAQ page and make automatically expand specific FAQ with a pag
 
 # Changelog
 
+= 6.1.5 =
+* Abbreviation functions support added as `es(..)`, `at(..)`, `abh(..)`, `eh()`, `ej()`, `et()` for use mostly in templates, but they can also be used in models, if you use observer models that may be generating and returning to controller whole HTML blocks. Also these functions may be valuable for developers, that wants to have their HTML templates (or PHP-enhanced templates) be fully based only on SolidMVC (MIT-licensed), and not WordPress (GPL-licensed), as in this case your templates would be intensively calling only the MIT-licensed SolidMVC micro-framework’s functions. Additionally, this allows you to write a shorter code for your templates, which is easier to read for your designers.
+* escBrHTML(..) support added for language interface.
+* Minor documentation and code tune-up.
+
 = 6.1.4 =
 * Small tune-up, gallery support added to configuration.
 * [SITE_URL] BBCode support added for install/import.

UI/Templates/Admin/Manual/Shared/InstructionsPartial.php

@@ -6,8 +6,8 @@
 </h1>
 <p><strong>Step 1</strong> - You already have the plugin installed in your system.</p>
 <ul>
-    <li><em>(Optional) Step 1.1</em> - If your theme <span class="failed"><strong>does not</strong></span> support FontAwesome icons,
-        please <span class="success"><strong>enable</strong></span> FontAwesome in Expandable FAQ -&gt; Settings -&gt; &quot;Global&quot; tab.</li>
+    <li><em>(Optional) Step 1.1</em> - If your theme <span class="success"><strong>already supports</strong></span> support FontAwesome icons,
+        please <span class="failed"><strong>disable</strong></span> FontAwesome in Expandable FAQ -&gt; Settings -&gt; &quot;Global&quot; tab.</li>
 </ul>
 <p><strong>Step 2</strong> - Now create a page by clicking the [Add New] button under the page menu.</p>
 <p><strong>Step 3</strong> - Add <strong>[expandable_faq display=&quot;faqs&quot; layout=&quot;list&quot;]</strong> shortcode to page content and click on [Publish] button.</p>

UI/Templates/Admin/Manual/Shared/ShortcodeParametersPartial.php

@@ -54,12 +54,13 @@
 </p>
 <ul>
     <li>
-        expanded_faq=&quot;1&quot; (default is no expanded F.A.Q.&#39;s - &#39;-1&#39;)
+        expanded_faq=&quot;4&quot; (default is no expanded F.A.Q.&#39;s - &#39;-1&#39;)
     </li>
 </ul>
 
 
 <h3>Example:</h3>
 <pre>
     [expandable_faq display=&quot;faqs&quot; layout=&quot;list&quot;]
+    [expandable_faq display=&quot;faqs&quot; expanded_faq=&quot;4&quot; layout=&quot;list&quot; style=&quot;2&quot;]
 </pre>

UI/Templates/Admin/Manual/Shared/URL_ParametersHashtagsPartial.php

@@ -34,4 +34,4 @@
 </ol>
 
 <h3>Example:</h3>
-<p>To expand a F.A.Q. with ID=1 and focus screen to it, go to &#39;https://your-site.com/faqs/?expanded_faq=1#faq-1&#39; URL.</p>
+<p>To expand a F.A.Q. with ID=4 and focus screen to it, go to &#39;https://your-site.com/faqs/?expanded_faq=4#faq-4&#39; URL.</p>

formatting.php

@@ -1,13 +1,42 @@
 <?php
 /**
- * Patches to Main WordPress Formatting API.
+ * S.O.L.I.D. MVC additional functions and abbreviations for Main WordPress Formatting API.
  *
  * This is the file of functions, that is missing in wp-includes\formatting.php
  *
  * @see \wp-includes\formatting.php
  * @package WordPress
  */
 
+if(!function_exists('es'))
+{
+    /**
+     * Short name for esc_sql
+     * @see esc_sql()
+     *
+     * @param string $text
+     * @return string
+     */
+    function es($text)
+    {
+        return esc_sql($text);
+    }
+}
+if(!function_exists('ea'))
+{
+    /**
+     * Short name for esc_attr
+     * @see esc_attr()
+     *
+     * @param string $text
+     * @return string
+     */
+    function ea($text)
+    {
+        return esc_attr($text);
+    }
+}
+
 if(!function_exists('esc_br_html'))
 {
     /**
@@ -25,4 +54,69 @@ function esc_br_html($text)
 
         return $escaped_multiline_text;
     }
+}
+
+if(!function_exists('ebh'))
+{
+    /**
+     * Short name for esc_br_html
+     * @see esc_br_html()
+     *
+     * Related ticked - https://core.trac.wordpress.org/ticket/46188
+     *
+     * @param string $text
+     * @return string
+     */
+    function ebh($text)
+    {
+        $escaped_text_array = array_map('esc_html', explode("\n", $text));
+        $escaped_multiline_text = implode("<br />", $escaped_text_array);
+
+        return $escaped_multiline_text;
+    }
+}
+
+if(!function_exists('eh'))
+{
+    /**
+     * Short name for esc_html
+     * @see esc_html()
+     *
+     * @param string $text
+     * @return string
+     */
+    function eh($text)
+    {
+        return esc_html($text);
+    }
+}
+
+if(!function_exists('ej'))
+{
+    /**
+     * Short name for esc_js
+     * @see esc_js()
+     *
+     * @param string $text
+     * @return string
+     */
+    function ej($text)
+    {
+        return esc_js($text);
+    }
+}
+
+if(!function_exists('et'))
+{
+    /**
+     * Short name for esc_textarea
+     * @see esc_textarea()
+     *
+     * @param string $text
+     * @return string
+     */
+    function et($text)
+    {
+        return esc_textarea($text);
+    }
 }