Merge pull request #5 from k1sul1/master

Allow enqueueing the script by registering it outside the if-clause + readme mentions

Author: Antti Kuosmanen

classes/class-cpt-wplf-form.php

@@ -445,9 +445,11 @@ function wplf_form( $id , $content = '', $xclass = '' ) {
   function maybe_enqueue_frontend_script() {
     global $post;
 
-    // only enqueue script if current post contains a form in it
+    // register the script, but only enqueue it if the current post contains a form in it
+    wp_register_script( 'wplf-form-js', plugins_url( 'assets/scripts/wplf-form.js', dirname(__FILE__) ), array( 'jquery' ) );
+
     if( is_a( $post, 'WP_Post' ) && ( has_shortcode( $post->post_content, 'libre-form') || $post->post_type === 'wplf-form') ) {
-      wp_enqueue_script( 'wplf-form-js', plugins_url( 'assets/scripts/wplf-form.js', dirname(__FILE__) ), array( 'jquery' ) );
+      wp_enqueue_script( 'wplf-form-js' );
       wp_localize_script( 'wplf-form-js', 'ajax_object', array( 'ajax_url' => admin_url( 'admin-ajax.php' ) ) );
     }
   }
@@ -480,4 +482,3 @@ function use_shortcode_for_preview( $content ) {
 }
 
 endif;
-

readme.md

@@ -79,6 +79,25 @@ function my_email_thankyou( $return ) {
 }
 ```
 
+### Use shortcodes outside post content
+
+By default, scripts are only loaded when the shortcode is within the content.
+If you use shortcodes outside the content, ex. custom fields or by `do_shortcode`, you need to manually enqueue the scripts for the submit to work.
+
+```php
+wp_enqueue_script('wplf-form-js');
+wp_localize_script( 'wplf-form-js', 'ajax_object', array( 'ajax_url' => admin_url( 'admin-ajax.php' ) ) );
+```
+
+### Add own css classes to form output
+
+You can use the attribute xclass inside the shortcode to set own extra css classes.
+
+```
+[libre-form id="1" xclass="extra"]
+```
+
+
 ### Filter: wplf_validate_submission
 
 Used to add validation to your forms