Changeset 1940701

Timestamp:

09/13/2018 12:55:41 PM (7 years ago)

Author:

zaus

Message:

v0.3 with more functions: param, page_url_domain, network url, time & date (+local), sitename, etc; screenshot

Location:

gf-dynamic-fields/trunk

Files:

• README.md (modified) (3 diffs)
• gravity-forms-dynamic-fields.php (modified) (4 diffs)
• readme.txt (modified) (3 diffs)
• screenshot-1.PNG (added)

gf-dynamic-fields/trunk/README.md

@@ -25 +25 @@
     * `session_desiredkey` where 'session_' is a prefix indicating you want a Session value and 'desiredkey' is the index of which Session value to retrieve
     * `cookie_desiredkey` where 'cookie_' is a prefix indicating you want a Cookie value and 'desiredkey' is the index of which Cookie value to retrieve
+    * `param_desiredkey` where 'param_' is a prefix indicating that you want a URL query parameter (or form POST) and 'desiredkey' is the index of the request parameter to retrieve.  Gravity Forms actually already does this, but it's included for consistency and this `param` will also check for POST parameters.
     * `page_url` gets the current WP page url
     * `page_url_nodomain` gets the current WP page url without the site domain (i.e. relative path)
+    * `page_url_domain` gets the domain of the current WP page url without the relative path
+    * `page_url_network` gets the network domain of the current WP page (useful with multisite); may be the same as `page_url_domain`
     * `page_referer` attempts to get the current referring url
-    * `page_request` gets the server-generated page url (which may/not be the same as `page_url`)
+    * `page_request` gets the server-generated page url (which may/not be the same as `page_url`, such as containing the querystring)
     * `page_ip` attempts to get the client's ip address
+    * `time` gets the current timestamp
+    * `date` gets the current ISO formatted date
+    * `time_local` gets the current timestamp formatted to your local settings
+    * `date_local` gets the current date formatted to your local settings
+    * `sitename` gets the blog's name as configured in your admin settings
 
 
 ## Frequently Asked Questions ##
+
+### How does Gravity Forms dynamically populate normally? ###
+
+See their wiki page for it -- https://docs.gravityforms.com/using-dynamic-population/
 
 ### How do I get a session value? ###
@@ -42 +54 @@
 See the installation instructions and use `cookie_yourdesiredkey` as the Parameter Name, where `yourdesiredkey` is the Cookie index you want.
 
+### How do I get a url querystring value? ###
+
+Use native GF functionality, or see the installation instructions and use `param_yourdesiredkey` as the Parameter Name, where `yourdesiredkey` is the querystring index you want.
+
 ### It doesn't work right... ###
 
@@ -48 +64 @@
 ## Screenshots ##
 
-N/A.
+1. Configuring Gravity Forms advanced field setting 'allow field to be populated dynamically'
 
 ## Changelog ##
+
+### 0.3 ###
+
+- added URL just domain
+- added time and date
+- added sitename
+- added querystring parameters
+- added other stuff, see installation
+- basically almost parity with [Forms 3rdparty Dynamic Fields](https://wordpress.org/plugins/forms-3rdparty-dynamic-fields/) plugin.
 
 ### 0.2 ###

gf-dynamic-fields/trunk/gravity-forms-dynamic-fields.php

@@ -6 +6 @@
 Description: Dynamically fill fields with session, cookie, or other values, based on 'Forms: 3rdparty Dynamic Fields'
 Author: zaus
-Version: 0.2
+Version: 0.3
 Author URI: http://drzaus.com
 Changelog:
     0.1 initial
     0.2 url without domain
+    0.3 url just domain, other parity with F3P Dynamic Fields
 */
 
@@ -21 +22 @@
     const COOKIE_PREFIX = 'cookie';
     const PAGE_PREFIX = 'page';
+    const PARAM_PREFIX = 'param';
+
+    const TIMESTAMP = 'time';
+    const DATE = 'date';
+    const DATE_I18N = 'date_local';
+    const TIME_I18N = 'time_local';
+    const SITENAME = 'sitename';
 
     const PAGE_URL = 'url';
     const PAGE_URL_NODOMAIN = 'url_nodomain';
+    const PAGE_DOMAIN = 'url_domain';
+    const PAGE_NETWORK_URL = 'url_network';
     const PAGE_REFERER = 'referer';
     const PAGE_REQUESTURL = 'request';
@@ -50 +60 @@
         ## _log(__CLASS__, $value, $name);
 
+        switch($name) {
+            case self::TIMESTAMP:
+                return time();
+            case self::DATE:
+                return date('c'); // ISO 8601 = Y-m-d\TH:i:sP (PHP5)
+            case self::DATE_I18N:
+                return date_i18n( get_option('date_format'), time() );
+            case self::TIME_I18N:
+                return date_i18n( get_option('time_format'), time() );
+            case self::SITENAME:
+                return get_bloginfo('name');
+
+        }
+
         $prefix = self::PAGE_PREFIX;
         if(strpos($name, $prefix) === 0) {
             $key = substr($name, strlen($prefix)+1);
 
-            switch($key) {
+            switch($key) {  
                 case self::PAGE_URL: return get_permalink();
+                case self::PAGE_DOMAIN: return get_site_url();
+                case self::PAGE_NETWORK_URL: return network_site_url();
                 case self::PAGE_URL_NODOMAIN: return str_replace(get_site_url(), '', get_permalink());
                 case self::PAGE_REFERER: return wp_get_referer();
@@ -91 +117 @@
         }
 
+        $prefix = self::PARAM_PREFIX;
+        if(strpos($name, $prefix) === 0) {
+            $key = substr($name, strlen($prefix)+1);
+
+            return isset($_REQUEST[ $key ]) ? $_REQUEST[ $key ] : $value;
+        }
+
         return $value;
     }

gf-dynamic-fields/trunk/readme.txt

@@ -25 +25 @@
     * `session_desiredkey` where 'session_' is a prefix indicating you want a Session value and 'desiredkey' is the index of which Session value to retrieve
     * `cookie_desiredkey` where 'cookie_' is a prefix indicating you want a Cookie value and 'desiredkey' is the index of which Cookie value to retrieve
+    * `param_desiredkey` where 'param_' is a prefix indicating that you want a URL query parameter (or form POST) and 'desiredkey' is the index of the request parameter to retrieve.  Gravity Forms actually already does this, but it's included for consistency and this `param` will also check for POST parameters.
     * `page_url` gets the current WP page url
     * `page_url_nodomain` gets the current WP page url without the site domain (i.e. relative path)
+    * `page_url_domain` gets the domain of the current WP page url without the relative path
+    * `page_url_network` gets the network domain of the current WP page (useful with multisite); may be the same as `page_url_domain`
     * `page_referer` attempts to get the current referring url
-    * `page_request` gets the server-generated page url (which may/not be the same as `page_url`)
+    * `page_request` gets the server-generated page url (which may/not be the same as `page_url`, such as containing the querystring)
     * `page_ip` attempts to get the client's ip address
+    * `time` gets the current timestamp
+    * `date` gets the current ISO formatted date
+    * `time_local` gets the current timestamp formatted to your local settings
+    * `date_local` gets the current date formatted to your local settings
+    * `sitename` gets the blog's name as configured in your admin settings
 
 
 == Frequently Asked Questions ==
+
+= How does Gravity Forms dynamically populate normally? =
+
+See their wiki page for it -- https://docs.gravityforms.com/using-dynamic-population/
 
 = How do I get a session value? =
@@ -42 +54 @@
 See the installation instructions and use `cookie_yourdesiredkey` as the Parameter Name, where `yourdesiredkey` is the Cookie index you want.
 
+### How do I get a url querystring value? ###
+
+Use native GF functionality, or see the installation instructions and use `param_yourdesiredkey` as the Parameter Name, where `yourdesiredkey` is the querystring index you want.
+
 = It doesn't work right... =
 
@@ -48 +64 @@
 == Screenshots ==
 
-N/A.
+1. Configuring Gravity Forms advanced field setting 'allow field to be populated dynamically'
 
 == Changelog ==
+
+= 0.3 =
+
+- added URL just domain
+- added time and date
+- added sitename
+- added querystring parameters
+- added other stuff, see installation
+- basically almost parity with [Forms 3rdparty Dynamic Fields](https://wordpress.org/plugins/forms-3rdparty-dynamic-fields/) plugin.
 
 = 0.2 =