` blocks.
- #
- $text = preg_replace_callback('{
+ /**
+ * @param $text
+ *
+ * @return mixed
+ */
+ public function doCodeBlocks( $text ) {
+
+ //
+ // Process Markdown `` blocks.
+ //
+ $text = preg_replace_callback( '{
(?:\n\n|\A\n?)
( # $1 = the code block -- one or more lines, starting with a space/tab
(?>
- [ ]{'.$this->tab_width.'} # Lines must start with a tab or a tab-width of spaces
+ [ ]{' . $this->tab_width . '} # Lines must start with a tab or a tab-width of spaces
.*\n+
)+
)
- ((?=^[ ]{0,'.$this->tab_width.'}\S)|\Z) # Lookahead for non-space at line-start, or end of doc
- }xm',
- array(&$this, '_doCodeBlocks_callback'), $text);
+ ((?=^[ ]{0,' . $this->tab_width . '}\S)|\Z) # Lookahead for non-space at line-start, or end of doc
+ }xm', array( &$this, '_doCodeBlocks_callback' ), $text );
- return $text;
- }
- function _doCodeBlocks_callback($matches) {
- $codeblock = $matches[1];
+ return $text;
+ }
- $codeblock = $this->outdent($codeblock);
- $codeblock = htmlspecialchars($codeblock, ENT_NOQUOTES);
+ /**
+ * @param $matches
+ *
+ * @return string
+ */
+ public function _doCodeBlocks_callback( $matches ) {
- # trim leading newlines and trailing newlines
- $codeblock = preg_replace('/\A\n+|\n+\z/', '', $codeblock);
+ $codeblock = $matches[1];
- $codeblock = "$codeblock\n
";
- return "\n\n".$this->hashBlock($codeblock)."\n\n";
- }
+ $codeblock = $this->outdent( $codeblock );
+ $codeblock = htmlspecialchars( $codeblock, ENT_NOQUOTES );
+ // trim leading newlines and trailing newlines
+ $codeblock = preg_replace( '/\A\n+|\n+\z/', '', $codeblock );
- function makeCodeSpan($code) {
- #
- # Create a code span markup for $code. Called from handleSpanToken.
- #
- $code = htmlspecialchars(trim($code), ENT_NOQUOTES);
- return $this->hashPart("$code");
- }
+ $codeblock = "$codeblock\n
";
+
+ return "\n\n" . $this->hashBlock( $codeblock ) . "\n\n";
+ }
+
+ /**
+ * @param $code
+ *
+ * @return string
+ */
+ public function makeCodeSpan( $code ) {
+ //
+ // Create a code span markup for $code. Called from handleSpanToken.
+ //
+ $code = htmlspecialchars( trim( $code ), ENT_NOQUOTES );
- var $em_relist = array(
- '' => '(?:(? '(?<=\S|^)(? '(?<=\S|^)(?hashPart( "$code" );
+ }
+
+ public $em_relist = array(
+ '' => '(?:(? '(?<=\S|^)(? '(?<=\S|^)(? '(?:(? '(?<=\S|^)(? '(?<=\S|^)(? '(?:(? '(?<=\S|^)(? '(?<=\S|^)(? '(?:(? '(?<=\S|^)(? '(?<=\S|^)(? '(?:(? '(?<=\S|^)(? '(?<=\S|^)(?em_relist as $em => $em_re) {
- foreach ($this->strong_relist as $strong => $strong_re) {
- # Construct list of allowed token expressions.
- $token_relist = array();
- if (isset($this->em_strong_relist["$em$strong"])) {
- $token_relist[] = $this->em_strong_relist["$em$strong"];
- }
- $token_relist[] = $em_re;
- $token_relist[] = $strong_re;
-
- # Construct master expression from list.
- $token_re = '{('. implode('|', $token_relist) .')}';
- $this->em_strong_prepared_relist["$em$strong"] = $token_re;
- }
- }
- }
+ public $em_strong_prepared_relist;
+
+ public function prepareItalicsAndBold() {
+
+ //
+ // Prepare regular expressions for searching emphasis tokens in any
+ // context.
+ //
+ foreach ( $this->em_relist as $em => $em_re ) {
+ foreach ( $this->strong_relist as $strong => $strong_re ) {
+ // Construct list of allowed token expressions.
+ $token_relist = array();
+ if ( isset( $this->em_strong_relist["$em$strong"] ) ) {
+ $token_relist[] = $this->em_strong_relist["$em$strong"];
+ }
+ $token_relist[] = $em_re;
+ $token_relist[] = $strong_re;
- function doItalicsAndBold($text) {
- $token_stack = array('');
- $text_stack = array('');
- $em = '';
- $strong = '';
- $tree_char_em = false;
-
- while (1) {
- #
- # Get prepared regular expression for seraching emphasis tokens
- # in current context.
- #
- $token_re = $this->em_strong_prepared_relist["$em$strong"];
-
- #
- # Each loop iteration search for the next emphasis token.
- # Each token is then passed to handleSpanToken.
- #
- $parts = preg_split($token_re, $text, 2, PREG_SPLIT_DELIM_CAPTURE);
- $text_stack[0] .= $parts[0];
- $token =& $parts[1];
- $text =& $parts[2];
-
- if (empty($token)) {
- # Reached end of text span: empty stack without emitting.
- # any more emphasis.
- while ($token_stack[0]) {
- $text_stack[1] .= array_shift($token_stack);
- $text_stack[0] .= array_shift($text_stack);
+ // Construct master expression from list.
+ $token_re = '{(' . implode( '|', $token_relist ) . ')}';
+ $this->em_strong_prepared_relist["$em$strong"] = $token_re;
}
- break;
}
+ }
- $token_len = strlen($token);
- if ($tree_char_em) {
- # Reached closing marker while inside a three-char emphasis.
- if ($token_len == 3) {
- # Three-char closing marker, close em and strong.
- array_shift($token_stack);
- $span = array_shift($text_stack);
- $span = $this->runSpanGamut($span);
- $span = "$span";
- $text_stack[0] .= $this->hashPart($span);
- $em = '';
- $strong = '';
- } else {
- # Other closing marker: close one em or strong and
- # change current token state to match the other
- $token_stack[0] = str_repeat($token{0}, 3-$token_len);
- $tag = $token_len == 2 ? "strong" : "em";
- $span = $text_stack[0];
- $span = $this->runSpanGamut($span);
- $span = "<$tag>$span";
- $text_stack[0] = $this->hashPart($span);
- $$tag = ''; # $$tag stands for $em or $strong
- }
- $tree_char_em = false;
- } else if ($token_len == 3) {
- if ($em) {
- # Reached closing marker for both em and strong.
- # Closing strong marker:
- for ($i = 0; $i < 2; ++$i) {
- $shifted_token = array_shift($token_stack);
- $tag = strlen($shifted_token) == 2 ? "strong" : "em";
- $span = array_shift($text_stack);
- $span = $this->runSpanGamut($span);
- $span = "<$tag>$span";
- $text_stack[0] .= $this->hashPart($span);
- $$tag = ''; # $$tag stands for $em or $strong
+ /**
+ * @param $text
+ *
+ * @return string
+ */
+ public function doItalicsAndBold( $text ) {
+
+ $token_stack = array( '' );
+ $text_stack = array( '' );
+ $em = '';
+ $strong = '';
+ $tree_char_em = false;
+
+ while ( 1 ) {
+ //
+ // Get prepared regular expression for seraching emphasis tokens
+ // in current context.
+ //
+ $token_re = $this->em_strong_prepared_relist["$em$strong"];
+
+ //
+ // Each loop iteration search for the next emphasis token.
+ // Each token is then passed to handleSpanToken.
+ //
+ $parts = preg_split( $token_re, $text, 2, PREG_SPLIT_DELIM_CAPTURE );
+ $text_stack[0] .= $parts[0];
+ $token =& $parts[1];
+ $text =& $parts[2];
+
+ if ( empty( $token ) ) {
+ // Reached end of text span: empty stack without emitting.
+ // any more emphasis.
+ while ( $token_stack[0] ) {
+ $text_stack[1] .= array_shift( $token_stack );
+ $text_stack[0] .= array_shift( $text_stack );
}
- } else {
- # Reached opening three-char emphasis marker. Push on token
- # stack; will be handled by the special condition above.
- $em = $token{0};
- $strong = "$em$em";
- array_unshift($token_stack, $token);
- array_unshift($text_stack, '');
- $tree_char_em = true;
+ break;
}
- } else if ($token_len == 2) {
- if ($strong) {
- # Unwind any dangling emphasis marker:
- if (strlen($token_stack[0]) == 1) {
- $text_stack[1] .= array_shift($token_stack);
- $text_stack[0] .= array_shift($text_stack);
+
+ $token_len = strlen( $token );
+ if ( $tree_char_em ) {
+ // Reached closing marker while inside a three-char emphasis.
+ if ( $token_len == 3 ) {
+ // Three-char closing marker, close em and strong.
+ array_shift( $token_stack );
+ $span = array_shift( $text_stack );
+ $span = $this->runSpanGamut( $span );
+ $span = "$span";
+ $text_stack[0] .= $this->hashPart( $span );
+ $em = '';
+ $strong = '';
+ } else {
+ // Other closing marker: close one em or strong and
+ // change current token state to match the other
+ $token_stack[0] = str_repeat( $token{0}, 3 - $token_len );
+ $tag = $token_len == 2 ? 'strong' : 'em';
+ $span = $text_stack[0];
+ $span = $this->runSpanGamut( $span );
+ $span = "<$tag>$span";
+ $text_stack[0] = $this->hashPart( $span );
+ $$tag = '';
+ // $$tag stands for $em or $strong
+ }//end if
+ $tree_char_em = false;
+ } elseif ( $token_len == 3 ) {
+ if ( $em ) {
+ // Reached closing marker for both em and strong.
+ // Closing strong marker:
+ for ( $i = 0; $i < 2; ++ $i ) {
+ $shifted_token = array_shift( $token_stack );
+ $tag = strlen( $shifted_token ) == 2 ? 'strong' : 'em';
+ $span = array_shift( $text_stack );
+ $span = $this->runSpanGamut( $span );
+ $span = "<$tag>$span";
+ $text_stack[0] .= $this->hashPart( $span );
+ $$tag = '';
+ // $$tag stands for $em or $strong
+ }
+ } else {
+ // Reached opening three-char emphasis marker. Push on token
+ // stack; will be handled by the special condition above.
+ $em = $token{0};
+ $strong = "$em$em";
+ array_unshift( $token_stack, $token );
+ array_unshift( $text_stack, '' );
+ $tree_char_em = true;
+ }//end if
+ } elseif ( $token_len == 2 ) {
+ if ( $strong ) {
+ // Unwind any dangling emphasis marker:
+ if ( strlen( $token_stack[0] ) == 1 ) {
+ $text_stack[1] .= array_shift( $token_stack );
+ $text_stack[0] .= array_shift( $text_stack );
+ }
+ // Closing strong marker:
+ array_shift( $token_stack );
+ $span = array_shift( $text_stack );
+ $span = $this->runSpanGamut( $span );
+ $span = "$span";
+ $text_stack[0] .= $this->hashPart( $span );
+ $strong = '';
+ } else {
+ array_unshift( $token_stack, $token );
+ array_unshift( $text_stack, '' );
+ $strong = $token;
}
- # Closing strong marker:
- array_shift($token_stack);
- $span = array_shift($text_stack);
- $span = $this->runSpanGamut($span);
- $span = "$span";
- $text_stack[0] .= $this->hashPart($span);
- $strong = '';
} else {
- array_unshift($token_stack, $token);
- array_unshift($text_stack, '');
- $strong = $token;
- }
- } else {
- # Here $token_len == 1
- if ($em) {
- if (strlen($token_stack[0]) == 1) {
- # Closing emphasis marker:
- array_shift($token_stack);
- $span = array_shift($text_stack);
- $span = $this->runSpanGamut($span);
- $span = "$span";
- $text_stack[0] .= $this->hashPart($span);
- $em = '';
+ // Here $token_len == 1
+ if ( $em ) {
+ if ( strlen( $token_stack[0] ) == 1 ) {
+ // Closing emphasis marker:
+ array_shift( $token_stack );
+ $span = array_shift( $text_stack );
+ $span = $this->runSpanGamut( $span );
+ $span = "$span";
+ $text_stack[0] .= $this->hashPart( $span );
+ $em = '';
+ } else {
+ $text_stack[0] .= $token;
+ }
} else {
- $text_stack[0] .= $token;
+ array_unshift( $token_stack, $token );
+ array_unshift( $text_stack, '' );
+ $em = $token;
}
- } else {
- array_unshift($token_stack, $token);
- array_unshift($text_stack, '');
- $em = $token;
- }
- }
+ }//end if
+ }//end while
+
+ return $text_stack[0];
}
- return $text_stack[0];
- }
+ /**
+ * @param $text
+ *
+ * @return mixed
+ */
+ public function doBlockQuotes( $text ) {
- function doBlockQuotes($text) {
- $text = preg_replace_callback('/
+ $text = preg_replace_callback( '/
( # Wrap whole match in $1
(?>
^[ ]*>[ ]? # ">" at the start of a line
@@ -1217,140 +1542,174 @@ function doBlockQuotes($text) {
\n* # blanks
)+
)
- /xm',
- array(&$this, '_doBlockQuotes_callback'), $text);
-
- return $text;
- }
- function _doBlockQuotes_callback($matches) {
- $bq = $matches[1];
- # trim one level of quoting - trim whitespace-only lines
- $bq = preg_replace('/^[ ]*>[ ]?|^[ ]+$/m', '', $bq);
- $bq = $this->runBlockGamut($bq); # recurse
-
- $bq = preg_replace('/^/m', " ", $bq);
- # These leading spaces cause problem with content,
- # so we need to fix that:
- $bq = preg_replace_callback('{(\s*.+?
)}sx',
- array(&$this, '_doBlockQuotes_callback2'), $bq);
-
- return "\n". $this->hashBlock("\n$bq\n
")."\n\n";
- }
- function _doBlockQuotes_callback2($matches) {
- $pre = $matches[1];
- $pre = preg_replace('/^ /m', '', $pre);
- return $pre;
- }
+ /xm', array( &$this, '_doBlockQuotes_callback' ), $text );
+ return $text;
+ }
- function formParagraphs($text) {
- #
- # Params:
- # $text - string to process with html tags
- #
- # Strip leading and trailing lines:
- $text = preg_replace('/\A\n+|\n+\z/', '', $text);
-
- $grafs = preg_split('/\n{2,}/', $text, -1, PREG_SPLIT_NO_EMPTY);
-
- #
- # Wrap
tags and unhashify HTML blocks
- #
- foreach ($grafs as $key => $value) {
- if (!preg_match('/^B\x1A[0-9]+B$/', $value)) {
- # Is a paragraph.
- $value = $this->runSpanGamut($value);
- $value = preg_replace('/^([ ]*)/', "
", $value);
- $value .= "
";
- $grafs[$key] = $this->unhash($value);
- }
- else {
- # Is a block.
- # Modify elements of @grafs in-place...
- $graf = $value;
- $block = $this->html_hashes[$graf];
- $graf = $block;
-// if (preg_match('{
-// \A
-// ( # $1 = tag
-// ]*
-// \b
-// markdown\s*=\s* ([\'"]) # $2 = attr quote char
-// 1
-// \2
-// [^>]*
-// >
-// )
-// ( # $3 = contents
-// .*
-// )
-// () # $4 = closing tag
-// \z
-// }xs', $block, $matches))
-// {
-// list(, $div_open, , $div_content, $div_close) = $matches;
-//
-// # We can't call Markdown(), because that resets the hash;
-// # that initialization code should be pulled into its own sub, though.
-// $div_content = $this->hashHTMLBlocks($div_content);
-//
-// # Run document gamut methods on the content.
-// foreach ($this->document_gamut as $method => $priority) {
-// $div_content = $this->$method($div_content);
-// }
-//
-// $div_open = preg_replace(
-// '{\smarkdown\s*=\s*([\'"]).+?\1}', '', $div_open);
-//
-// $graf = $div_open . "\n" . $div_content . "\n" . $div_close;
-// }
- $grafs[$key] = $graf;
- }
+ /**
+ * @param $matches
+ *
+ * @return string
+ */
+ public function _doBlockQuotes_callback( $matches ) {
+
+ $bq = $matches[1];
+ // trim one level of quoting - trim whitespace-only lines
+ $bq = preg_replace( '/^[ ]*>[ ]?|^[ ]+$/m', '', $bq );
+ $bq = $this->runBlockGamut( $bq );
+ // recurse
+ $bq = preg_replace( '/^/m', ' ', $bq );
+ // These leading spaces cause problem with content,
+ // so we need to fix that:
+ $bq = preg_replace_callback( '{(\s*.+?
)}sx', array( &$this, '_doBlockQuotes_callback2' ), $bq );
+
+ return "\n" . $this->hashBlock( "\n$bq\n
" ) . "\n\n";
}
- return implode("\n\n", $grafs);
- }
+ /**
+ * @param $matches
+ *
+ * @return mixed
+ */
+ public function _doBlockQuotes_callback2( $matches ) {
+ $pre = $matches[1];
+ $pre = preg_replace( '/^ /m', '', $pre );
- function encodeAttribute($text) {
- #
- # Encode text for a double-quoted HTML attribute. This function
- # is *not* suitable for attributes enclosed in single quotes.
- #
- $text = $this->encodeAmpsAndAngles($text);
- $text = str_replace('"', '"', $text);
- return $text;
- }
+ return $pre;
+ }
+
+ /**
+ * @param $text
+ *
+ * @return string
+ */
+ public function formParagraphs( $text ) {
+
+ //
+ // Params:
+ // $text - string to process with html tags
+ //
+ // Strip leading and trailing lines:
+ $text = preg_replace( '/\A\n+|\n+\z/', '', $text );
+
+ $grafs = preg_split( '/\n{2,}/', $text, - 1, PREG_SPLIT_NO_EMPTY );
+
+ //
+ // Wrap
tags and unhashify HTML blocks
+ //
+ foreach ( $grafs as $key => $value ) {
+ if ( ! preg_match( '/^B\x1A[0-9]+B$/', $value ) ) {
+ // Is a paragraph.
+ $value = $this->runSpanGamut( $value );
+ $value = preg_replace( '/^([ ]*)/', '
', $value );
+ $value .= '
';
+ $grafs[ $key ] = $this->unhash( $value );
+ } else {
+ // Is a block.
+ // Modify elements of @grafs in-place...
+ $graf = $value;
+ $block = $this->html_hashes[ $graf ];
+ $graf = $block;
+ // if (preg_match('{
+ // \A
+ // ( # $1 = tag
+ // ]*
+ // \b
+ // markdown\s*=\s* ([\'"]) # $2 = attr quote char
+ // 1
+ // \2
+ // [^>]*
+ // >
+ // )
+ // ( # $3 = contents
+ // .*
+ // )
+ // () # $4 = closing tag
+ // \z
+ // }xs', $block, $matches))
+ // {
+ // list(, $div_open, , $div_content, $div_close) = $matches;
+ //
+ // # We can't call Markdown(), because that resets the hash;
+ // # that initialization code should be pulled into its own sub, though.
+ // $div_content = $this->hashHTMLBlocks($div_content);
+ //
+ // # Run document gamut methods on the content.
+ // foreach ($this->document_gamut as $method => $priority) {
+ // $div_content = $this->$method($div_content);
+ // }
+ //
+ // $div_open = preg_replace(
+ // '{\smarkdown\s*=\s*([\'"]).+?\1}', '', $div_open);
+ //
+ // $graf = $div_open . "\n" . $div_content . "\n" . $div_close;
+ // }
+ $grafs[ $key ] = $graf;
+ }//end if
+ }//end foreach
+
+ return implode( "\n\n", $grafs );
+ }
+ /**
+ * @param $text
+ *
+ * @return mixed
+ */
+ public function encodeAttribute( $text ) {
- function encodeAmpsAndAngles($text) {
- #
- # Smart processing for ampersands and angle brackets that need to
- # be encoded. Valid character entities are left alone unless the
- # no-entities mode is set.
- #
- if ($this->no_entities) {
- $text = str_replace('&', '&', $text);
- } else {
- # Ampersand-encoding based entirely on Nat Irons's Amputator
- # MT plugin:
- $text = preg_replace_callback('{
+ // Email addresses:
+ $text = preg_replace_callback( '{
<
(?:mailto:)?
(
@@ -1367,295 +1726,384 @@ function doAutoLinks($text) {
)
)
>
- }xi',
- array(&$this, '_doAutoLinks_email_callback'), $text);
+ }xi', array( &$this, '_doAutoLinks_email_callback' ), $text );
+ $text = preg_replace_callback( '{<(tel:([^\'">\s]+))>}i', array(
+ &$this,
+ '_doAutoLinks_tel_callback',
+ ), $text );
- return $text;
- }
- function _doAutoLinks_url_callback($matches) {
- $url = $this->encodeAttribute($matches[1]);
- $link = "$url";
- return $this->hashPart($link);
- }
- function _doAutoLinks_email_callback($matches) {
- $address = $matches[1];
- $link = $this->encodeEmailAddress($address);
- return $this->hashPart($link);
- }
+ return $text;
+ }
+ /**
+ * @param $matches
+ *
+ * @return string
+ */
+ public function _doAutoLinks_tel_callback( $matches ) {
- function encodeEmailAddress($addr) {
- #
- # Input: an email address, e.g. "foo@example.com"
- #
- # Output: the email address as a mailto link, with each character
- # of the address encoded as either a decimal or hex entity, in
- # the hopes of foiling most address harvesting spam bots. E.g.:
- #
- #
- #
- # Based by a filter by Matthew Wickline, posted to BBEdit-Talk.
- # With some optimizations by Milian Wolff.
- #
- $addr = "mailto:" . $addr;
- $chars = preg_split('/(? $char) {
- $ord = ord($char);
- # Ignore non-ascii chars.
- if ($ord < 128) {
- $r = ($seed * (1 + $key)) % 100; # Pseudo-random function.
- # roughly 10% raw, 45% hex, 45% dec
- # '@' *must* be encoded. I insist.
- if ($r > 90 && $char != '@') /* do nothing */;
- else if ($r < 45) $chars[$key] = '&#x'.dechex($ord).';';
- else $chars[$key] = '&#'.$ord.';';
- }
+ $url = $this->encodeAttribute( $matches[1] );
+ $tel = $this->encodeAttribute( $matches[2] );
+ $link = "$tel";
+
+ return $this->hashPart( $link );
}
- $addr = implode('', $chars);
- $text = implode('', array_slice($chars, 7)); # text without `mailto:`
- $addr = "$text";
+ /**
+ * @param $matches
+ *
+ * @return string
+ */
+ public function _doAutoLinks_url_callback( $matches ) {
- return $addr;
- }
+ $url = $this->encodeAttribute( $matches[1] );
+ $link = "$url";
+
+ return $this->hashPart( $link );
+ }
+
+ /**
+ * @param $matches
+ *
+ * @return string
+ */
+ public function _doAutoLinks_email_callback( $matches ) {
+
+ $address = $matches[1];
+ $link = $this->encodeEmailAddress( $address );
+
+ return $this->hashPart( $link );
+ }
+
+ /**
+ * @param $addr
+ *
+ * @return string
+ */
+ public function encodeEmailAddress( $addr ) {
+
+ //
+ // Input: an email address, e.g. "foo@example.com"
+ //
+ // Output: the email address as a mailto link, with each character
+ // of the address encoded as either a decimal or hex entity, in
+ // the hopes of foiling most address harvesting spam bots. E.g.:
+ //
+ //
+ //
+ // Based by a filter by Matthew Wickline, posted to BBEdit-Talk.
+ // With some optimizations by Milian Wolff.
+ //
+ $addr = 'mailto:' . $addr;
+ $chars = preg_split( '/(? $char ) {
+ $ord = ord( $char );
+ // Ignore non-ascii chars.
+ if ( $ord < 128 ) {
+ $r = ( $seed * ( 1 + $key ) ) % 100;
+ // Pseudo-random function.
+ // roughly 10% raw, 45% hex, 45% dec
+ // '@' *must* be encoded. I insist.
+ if ( $r > 90 && $char != '@' ) { /* do nothing */
+ } elseif ( $r < 45 ) {
+ $chars[ $key ] = '&#x' . dechex( $ord ) . ';';
+ } else {
+ $chars[ $key ] = '&#' . $ord . ';';
+ }
+ }
+ }
+
+ $addr = implode( '', $chars );
+ $text = implode( '', array_slice( $chars, 7 ) );
+ // text without `mailto:`
+ $addr = "$text";
+
+ return $addr;
+ }
+ /**
+ * @param $str
+ *
+ * @return string
+ */
+ public function parseSpan( $str ) {
- function parseSpan($str) {
- #
- # Take the string $str and parse it into tokens, hashing embeded HTML,
- # escaped characters and handling code spans.
- #
- $output = '';
+ //
+ // Take the string $str and parse it into tokens, hashing embeded HTML,
+ // escaped characters and handling code spans.
+ //
+ $output = '';
- $span_re = '{
+ $span_re = '{
(
- \\\\'.$this->escape_chars_re.'
+ \\\\' . $this->escape_chars_re . '
|
(?no_markup ? '' : '
+ ' . ( $this->no_markup ? '' : '
|
# comment
|
<\?.*?\?> | <%.*?%> # processing instruction
|
- <[/!$]?[-a-zA-Z0-9:_]+ # regular tags
+ <[!$]?[-a-zA-Z0-9:_]+ # regular tags
(?>
\s
(?>[^"\'>]+|"[^"]*"|\'[^\']*\')*
)?
>
- ').'
+ |
+ <[-a-zA-Z0-9:_]+\s*/> # xml-style empty tag
+ |
+ # closing tag
+ ' ) . '
)
}xs';
- while (1) {
- #
- # Each loop iteration seach for either the next tag, the next
- # openning code span marker, or the next escaped character.
- # Each token is then passed to handleSpanToken.
- #
- $parts = preg_split($span_re, $str, 2, PREG_SPLIT_DELIM_CAPTURE);
-
- # Create token from text preceding tag.
- if ($parts[0] != "") {
- $output .= $parts[0];
- }
+ while ( 1 ) {
+ //
+ // Each loop iteration seach for either the next tag, the next
+ // openning code span marker, or the next escaped character.
+ // Each token is then passed to handleSpanToken.
+ //
+ $parts = preg_split( $span_re, $str, 2, PREG_SPLIT_DELIM_CAPTURE );
+
+ // Create token from text preceding tag.
+ if ( $parts[0] != '' ) {
+ $output .= $parts[0];
+ }
- # Check if we reach the end.
- if (isset($parts[1])) {
- $output .= $this->handleSpanToken($parts[1], $parts[2]);
- $str = $parts[2];
- }
- else {
- break;
- }
+ // Check if we reach the end.
+ if ( isset( $parts[1] ) ) {
+ $output .= $this->handleSpanToken( $parts[1], $parts[2] );
+ $str = $parts[2];
+ } else {
+ break;
+ }
+ }//end while
+
+ return $output;
}
- return $output;
- }
+ /**
+ * @param $token
+ * @param $str
+ *
+ * @return string
+ */
+ public function handleSpanToken( $token, &$str ) {
+
+ //
+ // Handle $token provided by parseSpan by determining its nature and
+ // returning the corresponding value that should replace it.
+ //
+ switch ( $token{0} ) {
+ case '\\':
+ return $this->hashPart( '&#' . ord( $token{1} ) . ';' );
+ case '`':
+ // Search for end marker in remaining text.
+ if ( preg_match( '/^(.*?[^`])' . preg_quote( $token ) . '(?!`)(.*)$/sm', $str, $matches ) ) {
+ $str = $matches[2];
+ $codespan = $this->makeCodeSpan( $matches[1] );
+
+ return $this->hashPart( $codespan );
+ }
+ return $token;
+ // return as text since no ending marker found.
+ default:
+ return $this->hashPart( $token );
+ }
+ }
- function handleSpanToken($token, &$str) {
- #
- # Handle $token provided by parseSpan by determining its nature and
- # returning the corresponding value that should replace it.
- #
- switch ($token{0}) {
- case "\\":
- return $this->hashPart("&#". ord($token{1}). ";");
- case "`":
- # Search for end marker in remaining text.
- if (preg_match('/^(.*?[^`])'.preg_quote($token).'(?!`)(.*)$/sm',
- $str, $matches))
- {
- $str = $matches[2];
- $codespan = $this->makeCodeSpan($matches[1]);
- return $this->hashPart($codespan);
- }
- return $token; // return as text since no ending marker found.
- default:
- return $this->hashPart($token);
+ /**
+ * @param $text
+ *
+ * @return mixed
+ */
+ public function outdent( $text ) {
+
+ //
+ // Remove one level of line-leading tabs or spaces
+ //
+ return preg_replace( '/^(\t|[ ]{1,' . $this->tab_width . '})/m', '', $text );
}
- }
- function outdent($text) {
- #
- # Remove one level of line-leading tabs or spaces
- #
- return preg_replace('/^(\t|[ ]{1,'.$this->tab_width.'})/m', '', $text);
- }
+ // String length function for detab. `_initDetab` will create a function to
+ // hanlde UTF-8 if the default function does not exist.
+ public $utf8_strlen = 'mb_strlen';
+ /**
+ * @param $text
+ *
+ * @return mixed
+ */
+ public function detab( $text ) {
- # String length function for detab. `_initDetab` will create a function to
- # hanlde UTF-8 if the default function does not exist.
- var $utf8_strlen = 'mb_strlen';
+ //
+ // Replace tabs with the appropriate amount of space.
+ //
+ // For each line we separate the line in blocks delemited by
+ // tab characters. Then we reconstruct every line by adding the
+ // appropriate number of space between each blocks.
+ $text = preg_replace_callback( '/^.*\t.*$/m', array( &$this, '_detab_callback' ), $text );
- function detab($text) {
- #
- # Replace tabs with the appropriate amount of space.
- #
- # For each line we separate the line in blocks delemited by
- # tab characters. Then we reconstruct every line by adding the
- # appropriate number of space between each blocks.
+ return $text;
+ }
- $text = preg_replace_callback('/^.*\t.*$/m',
- array(&$this, '_detab_callback'), $text);
+ /**
+ * @param $matches
+ *
+ * @return string
+ */
+ public function _detab_callback( $matches ) {
+
+ $line = $matches[0];
+ $strlen = $this->utf8_strlen;
+ // strlen function for UTF-8.
+ // Split in blocks.
+ $blocks = explode( "\t", $line );
+ // Add each blocks to the line.
+ $line = $blocks[0];
+ unset( $blocks[0] );
+ // Do not add first block twice.
+ foreach ( $blocks as $block ) {
+ // Calculate amount of space, insert spaces, insert block.
+ $amount = $this->tab_width - $strlen( $line, 'UTF-8' ) % $this->tab_width;
+ $line .= str_repeat( ' ', $amount ) . $block;
+ }
- return $text;
- }
- function _detab_callback($matches) {
- $line = $matches[0];
- $strlen = $this->utf8_strlen; # strlen function for UTF-8.
-
- # Split in blocks.
- $blocks = explode("\t", $line);
- # Add each blocks to the line.
- $line = $blocks[0];
- unset($blocks[0]); # Do not add first block twice.
- foreach ($blocks as $block) {
- # Calculate amount of space, insert spaces, insert block.
- $amount = $this->tab_width -
- $strlen($line, 'UTF-8') % $this->tab_width;
- $line .= str_repeat(" ", $amount) . $block;
+ return $line;
}
- return $line;
- }
- function _initDetab() {
- #
- # Check for the availability of the function in the `utf8_strlen` property
- # (initially `mb_strlen`). If the function is not available, create a
- # function that will loosely count the number of UTF-8 characters with a
- # regular expression.
- #
- if (function_exists($this->utf8_strlen)) return;
- $this->utf8_strlen = create_function('$text', 'return preg_match_all(
+
+ public function _initDetab() {
+
+ //
+ // Check for the availability of the function in the `utf8_strlen` property
+ // (initially `mb_strlen`). If the function is not available, create a
+ // function that will loosely count the number of UTF-8 characters with a
+ // regular expression.
+ //
+ if ( function_exists( $this->utf8_strlen ) ) {
+ return;
+ }
+ $this->utf8_strlen = create_function( '$text', 'return preg_match_all(
"/[\\\\x00-\\\\xBF]|[\\\\xC0-\\\\xFF][\\\\x80-\\\\xBF]*/",
- $text, $m);');
- }
+ $text, $m);' );
+ }
+ /**
+ * @param $text
+ *
+ * @return mixed
+ */
+ public function unhash( $text ) {
+
+ //
+ // Swap back in all the tags hashed by _HashHTMLBlocks.
+ //
+ return preg_replace_callback( '/(.)\x1A[0-9]+\1/', array( &$this, '_unhash_callback' ), $text );
+ }
- function unhash($text) {
- #
- # Swap back in all the tags hashed by _HashHTMLBlocks.
- #
- return preg_replace_callback('/(.)\x1A[0-9]+\1/',
- array(&$this, '_unhash_callback'), $text);
- }
- function _unhash_callback($matches) {
- return $this->html_hashes[$matches[0]];
- }
+ /**
+ * @param $matches
+ *
+ * @return mixed
+ */
+ public function _unhash_callback( $matches ) {
-}
+ return $this->html_hashes[ $matches[0] ];
+ }
-/*
+ }
-PHP Markdown
-============
+ /*
+ PHP Markdown
+ ============
-Description
------------
+ Description
+ -----------
-This is a PHP translation of the original Markdown formatter written in
-Perl by John Gruber.
+ This is a PHP translation of the original Markdown formatter written in
+ Perl by John Gruber.
-Markdown is a text-to-HTML filter; it translates an easy-to-read /
-easy-to-write structured text format into HTML. Markdown's text format
-is most similar to that of plain text email, and supports features such
-as headers, *emphasis*, code blocks, blockquotes, and links.
+ Markdown is a text-to-HTML filter; it translates an easy-to-read /
+ easy-to-write structured text format into HTML. Markdown's text format
+ is mostly similar to that of plain text email, and supports features such
+ as headers, *emphasis*, code blocks, blockquotes, and links.
-Markdown's syntax is designed not as a generic markup language, but
-specifically to serve as a front-end to (X)HTML. You can use span-level
-HTML tags anywhere in a Markdown document, and you can use block level
-HTML tags (like and as well).
+ Markdown's syntax is designed not as a generic markup language, but
+ specifically to serve as a front-end to (X)HTML. You can use span-level
+ HTML tags anywhere in a Markdown document, and you can use block level
+ HTML tags (like and as well).
-For more information about Markdown's syntax, see:
+ For more information about Markdown's syntax, see:
-
+
-Please include with your report: (1) the example input; (2) the output you
-expected; (3) the output Markdown actually produced.
+ Please include with your report: (1) the example input; (2) the output you
+ expected; (3) the output Markdown actually produced.
-Version History
----------------
+ Version History
+ ---------------
-See the readme file for detailed release notes for this version.
+ See the readme file for detailed release notes for this version.
-Copyright and License
----------------------
+ Copyright and License
+ ---------------------
-PHP Markdown
-Copyright (c) 2004-2009 Michel Fortin
-%s
%s', __( 'Populate Related Items from Pods', 'pods-gravity-forms' ), __( 'Check this box to populate the related items from Pods instead of keeping the list up-to-date manually.' ) );
@@ -479,36 +838,209 @@ public function populate_related_items_tooltip( $tooltips ) {
}
+ /**
+ *
+ */
public function init() {
parent::init();
if ( $this->is_gravityforms_supported() ) {
- add_filter( 'gform_pre_render', array( $this, '_gf_pre_render' ) );
+ // Handle normal forms.
+ add_filter( 'gform_pre_render', array( $this, '_gf_pre_render' ), 9, 2 );
+ add_filter( 'gform_admin_pre_render', array( $this, '_gf_pre_render' ), 9, 1 );
add_filter( 'gform_pre_process', array( $this, '_gf_pre_process' ) );
+
+ // Handle merge tags
+ add_filter( 'gform_custom_merge_tags', array( $this, '_gf_custom_merge_tags' ), 10, 2 );
+ add_filter( 'gform_merge_tag_data', array( $this, '_gf_add_merge_tags' ), 10, 3 );
+ add_filter( 'gform_replace_merge_tags', array( $this, '_gf_replace_merge_tags' ), 10, 2 );
+
+ // Handle entry detail edits.
+ add_action( 'gform_pre_entry_detail', array( $this, '_gf_pre_entry_detail' ), 10, 2 );
+ add_action( 'check_admin_referer', array( $this, '_check_admin_referer' ), 10, 2 );
+ add_action( 'gform_entry_detail_content_before', array( $this, '_gf_entry_detail_content_before' ), 10, 2 );
+
+ // Handle entry updates.
+ add_action( 'gform_post_update_entry', array( $this, '_gf_post_update_entry' ), 9, 2 );
+ add_action( 'gform_after_update_entry', array( $this, '_gf_after_update_entry' ), 9, 3 );
+
+ // Handle Payment Add-on callbacks.
+ add_action( 'gform_action_pre_payment_callback', array( $this, '_gf_action_pre_payment_callback' ), 10, 2 );
+ }
+
+ }
+
+ /**
+ * Processes feed action.
+ *
+ * @since Unknown
+ * @access public
+ *
+ * @param array $feed The Feed Object currently being processed.
+ * @param array $entry The Entry Object currently being processed.
+ * @param array $form The Form Object currently being processed.
+ *
+ * @return array|null Returns a modified entry object or null.
+ */
+ public function process_feed( $feed, $entry, $form ) {
+
+ if ( empty( $this->pods_gf[ $feed['id'] ] ) ) {
+ return null;
+ }
+
+ $form = $this->_gf_pre_render( $form, $entry );
+
+ /** @var Pods_GF $pods_gf */
+ $pods_gf = $this->pods_gf[ $feed['id'] ];
+
+ try {
+ $pods_gf->options['entry'] = $entry;
+
+ $id = $pods_gf->_gf_to_pods_handler( $form, $entry );
+
+ // Set post_id if we have it.
+ if ( 'post_type' === $pods_gf->pod->pod_data['type'] ) {
+ $entry['post_id'] = $id;
+
+ return $entry;
+ }
+ }
+ catch ( Exception $e ) {
+ // @todo Log something to the form entry
+ }
+
+ return null;
+
+ }
+
+ /**
+ * Action handler for Gravity Forms: gform_action_pre_payment_callback.
+ *
+ * @param array $action Action data being saved.
+ * @param array $entry GF Entry array.
+ */
+ public function _gf_action_pre_payment_callback( $action, $entry ) {
+
+ $form = GFAPI::get_form( $entry['form_id'] );
+
+ $this->_gf_pre_process( $form );
+
+ }
+
+ /**
+ * Action handler for Gravity Forms: gform_post_update_entry.
+ *
+ * @param array $entry GF Entry array
+ * @param array $original_entry Original GF Entry array
+ */
+ public function _gf_post_update_entry( $entry, $original_entry ) {
+
+ $form = GFAPI::get_form( $entry['form_id'] );
+
+ $this->_gf_pre_process( $form );
+
+ }
+
+ /**
+ * Action handler for Gravity Forms: gform_after_update_entry.
+ *
+ * @param array $form GF Form array
+ * @param array $entry GF Entry array
+ * @param array $original_entry Original GF Entry array
+ */
+ public function _gf_after_update_entry( $form, $entry, $original_entry ) {
+
+ $this->_gf_pre_process( $form );
+
+ }
+
+ /**
+ * Hook into action to setup Pods GF add-on hooks before form entry edit form is shown.
+ *
+ * @param array|object $form GF form data.
+ * @param array|object $entry GF entry data.
+ */
+ public function _gf_pre_entry_detail( $form, $entry ) {
+
+ // Remove other hooks for workarounds we don't need if this hook now exists. Not in GF when this was written.
+ remove_action( 'check_admin_referer', array( $this, '_check_admin_referer' ) );
+ remove_action( 'gform_entry_detail_content_before', array( $this, '_gf_entry_detail_content_before' ) );
+
+ $this->_gf_pre_render( $form, $entry, true );
+
+ }
+
+ /**
+ * Hook into check_admin_referer to setup Pods GF add-on hooks before updating form entry.
+ *
+ * @param string $action The nonce action.
+ * @param false|int $result False if the nonce is invalid, 1 if the nonce is valid and generated between
+ * 0-12 hours ago, 2 if the nonce is valid and generated between 12-24 hours ago.
+ */
+ public function _check_admin_referer( $action, $result ) {
+
+ // So hacky, we need GF to add a better hook than this.
+ if ( $result && 'gforms_save_entry' === $action ) {
+ $form = GFEntryDetail::get_current_form();
+
+ $this->_gf_pre_process( $form );
}
}
- public function _gf_pre_render( $form ) {
+ /**
+ * Hook into action to setup Pods GF add-on hooks before form entry edit form is shown.
+ *
+ * @param array|object $form GF form data.
+ * @param array|object $entry GF entry data.
+ */
+ public function _gf_entry_detail_content_before( $form, $entry ) {
+
+ $this->_gf_pre_render( $form, $entry, true );
+
+ }
+
+ /**
+ * @param $form
+ *
+ * @return mixed
+ */
+ public function _gf_pre_render( $form, $entry = null, $admin_edit = false ) {
+
+ static $setup = array();
+
+ if ( ! empty( $setup[ $form['id'] ] ) ) {
+ return $setup[ $form['id'] ];
+ }
$feeds = $this->get_feeds( $form['id'] );
if ( empty( $feeds ) ) {
- return $form;
+ $setup[ $form['id'] ] = $form;
+
+ return $setup[ $form['id'] ];
}
$pod_fields = array();
$pod_name = '';
$feed = null;
+ if ( empty( $entry ) ) {
+ $entry = GFFormsModel::get_current_lead();
+ }
+
foreach ( $feeds as $feed ) {
if ( 1 !== (int) $feed['is_active'] ) {
continue;
}
- $pod_fields = $this->get_field_map_fields_with_custom_values( $feed, 'pod_fields' );
- $object_fields = $this->get_field_map_fields_with_custom_values( $feed, 'wp_object_fields' );
+ if ( $admin_edit && empty( $feed['meta']['update_pod_item'] ) ) {
+ continue;
+ }
+
+ $pod_fields = self::get_field_map_fields_with_custom_values( $feed, 'pod_fields' );
+ $object_fields = self::get_field_map_fields_with_custom_values( $feed, 'wp_object_fields' );
$pod_fields = array_merge( $pod_fields, $object_fields );
@@ -521,9 +1053,13 @@ public function _gf_pre_render( $form ) {
$pod_obj = pods( $pod_name, null, false );
if ( empty( $pod_obj ) || ! $pod_obj->valid() ) {
- return $form;
+ $setup[ $form['id'] ] = $form;
+
+ return $setup[ $form['id'] ];
}
+ $dynamic_selects = array();
+
/**
* @var GF_Field $gf_field
*/
@@ -541,167 +1077,323 @@ public function _gf_pre_render( $form ) {
continue;
}
- $data = $pod_obj->fields( $pod_field, 'data' );
+ $pod_field_options = $pod_obj->fields( $pod_field );
+
+ // Override limit for autocomplete
+ $object_params = array(
+ 'limit' => -1,
+ );
+
+ $data = PodsForm::field_method( $pod_field_options['type'], 'get_field_data', $pod_field_options, array(), $object_params );
if ( empty( $data ) ) {
continue;
}
+ if ( isset( $data[''] ) ) {
+ unset( $data[''] );
+ }
+
+ $select_text = pods_v( $pod_field_options['type'] . '_select_text', $pod_field_options['options'], __( '-- Select One --', 'pods' ), true );
+
$options = array(
'options' => $data,
);
- Pods_GF::dynamic_select( $form['id'], (string) $gf_field->id, $options );
+ if ( $select_text ) {
+ $options['select_text'] = $select_text;
+ }
+
+ $dynamic_selects[ $gf_field->id ] = $options;
}
}
- // Support other options like prepopulating etc
- $this->_gf_pre_process( $form );
+ if ( ! empty( $dynamic_selects ) ) {
+ $form = Pods_GF::gf_dynamic_select( $form, $dynamic_selects );
+ }
}
- return $form;
+ $form = $this->_gf_pre_process( $form );
+
+ $setup[ $form['id'] ] = $form;
+
+ return $setup[ $form['id'] ];
}
+ /**
+ * @param $form
+ *
+ * @return mixed
+ */
public function _gf_pre_process( $form ) {
static $setup = array();
if ( ! empty( $setup[ $form['id'] ] ) ) {
- return $form;
+ return $setup[ $form['id'] ];
}
$feeds = $this->get_feeds( $form['id'] );
+ $entry = GFFormsModel::get_current_lead();
+
if ( ! empty( $feeds ) ) {
foreach ( $feeds as $feed ) {
- if ( 1 !== (int) $feed['is_active'] ) {
+ if ( 1 !== (int) $feed['is_active'] && $this->is_feed_condition_met( $feed, $form, $entry ) ) {
continue;
}
- // Block new post being created in GF
- add_filter( 'gform_disable_post_creation_' . $form['id'], '__return_true' );
+ $this->setup_pods_gf( $form, $feed );
+ }
+ }
- $pod_fields = $this->get_field_map_fields_with_custom_values( $feed, 'pod_fields' );
- $object_fields = $this->get_field_map_fields_with_custom_values( $feed, 'wp_object_fields' );
+ $setup[ $form['id'] ] = $form;
- $fields = array_merge( $pod_fields, $object_fields );
+ return $setup[ $form['id'] ];
- $options = array(
- // array ( 'gf_field_id' => 'pod_field_name' )
- 'fields' => $fields,
- 'auto_delete' => (int) pods_v( 'delete_entry', $feed['meta'], 0 ),
- 'markdown' => (int) pods_v( 'enable_markdown', $feed['meta'], 0 ),
- 'gf_to_pods_priority' => 'submission',
- );
+ }
- // Setup pod object
- $pod = pods( $feed['meta']['pod'] );
+ /**
+ * @param array $form Form object.
+ * @param array $feed Feed object.
+ *
+ * @return boolean
+ */
+ public function setup_pods_gf( $form, $feed ) {
- $edit_id = 0;
- $prepopulate = false;
- $prepopulate_id = 0;
+ // Block new post being created in GF
+ add_filter( 'gform_disable_post_creation_' . $form['id'], '__return_true' );
- if ( 'user' === $pod->pod_data['type'] && is_user_logged_in() ) {
- // Support user data editing
- if ( 1 === (int) pods_v( 'enable_current_user', $feed['meta'], 0 ) ) {
- $edit_id = get_current_user_id();
- }
+ $pod_fields = self::get_field_map_fields_with_custom_values( $feed, 'pod_fields' );
+ $object_fields = self::get_field_map_fields_with_custom_values( $feed, 'wp_object_fields' );
+ $custom_fields = self::get_field_map_custom_fields_with_custom_values( $feed );
- // Support prepopulating
- if ( 1 === (int) pods_v( 'enable_prepopulate', $feed['meta'], 0 ) ) {
- $prepopulate = true;
+ $fields = array_merge( $pod_fields, $object_fields, $custom_fields );
- $prepopulate_id = get_current_user_id();
- }
- } elseif ( 'post_type' === $pod->pod_data['type'] && is_singular( $pod->pod ) ) {
- // Support post data editing
- if ( 1 === (int) pods_v( 'enable_current_post', $feed['meta'], 0 ) ) {
- $edit_id = get_the_ID();
- }
+ $options = array(
+ // array ( 'gf_field_id' => 'pod_field_name' )
+ 'fields' => $fields,
+ 'update_pod_item' => (int) pods_v( 'update_pod_item', $feed['meta'], 0 ),
+ 'markdown' => (int) pods_v( 'enable_markdown', $feed['meta'], 0 ),
+ 'auto_delete' => (int) pods_v( 'delete_entry', $feed['meta'], 0 ),
+ 'gf_to_pods_priority' => 'submission',
+ );
- // Support prepopulating
- if ( 1 === (int) pods_v( 'enable_prepopulate', $feed['meta'], 0 ) ) {
- $prepopulate = true;
+ // Setup pod object
+ $pod = pods( $feed['meta']['pod'] );
- $prepopulate_id = get_the_ID();
- }
- }
+ $edit_id = 0;
+ $prepopulate = false;
+ $prepopulate_id = 0;
- /**
- * Allow filtering of which item ID to use when editing (default none, always add new items)
- *
- * @param int $edit_id Edit ID
- * @param string $pod_name Pod name
- * @param int $form_id GF Form ID
- * @param array $feed GF Form feed array
- * @param array $form GF Form array
- * @param array $options Pods GF options
- * @param Pods $pod Pods object
- */
- $edit_id = (int) apply_filters( 'pods_gf_addon_edit_id', $edit_id, $feed['meta']['pod'], $form['id'], $feed, $form, $options, $pod );
-
- /**
- * Allow filtering of whether to prepopulate form fields (default none)
- *
- * @param bool $prepopulate Whether to prepopulate or not
- * @param string $pod_name Pod name
- * @param int $form_id GF Form ID
- * @param array $feed GF Form feed array
- * @param array $form GF Form array
- * @param array $options Pods GF options
- * @param Pods $pod Pods object
- */
- $prepopulate = (boolean) apply_filters( 'pods_gf_addon_prepopulate', $prepopulate, $feed['meta']['pod'], $form['id'], $feed, $form, $options, $pod );
-
- if ( empty( $edit_id ) && $prepopulate ) {
- /**
- * Allow filtering of which item ID to use when prepopulating form fields (default is same as Edit ID)
- *
- * @param int $prepopulate_id ID to use when prepopulating
- * @param string $pod_name Pod name
- * @param int $form_id GF Form ID
- * @param array $feed GF Form feed array
- * @param array $form GF Form array
- * @param array $options Pods GF options
- * @param Pods $pod Pods object
- */
- $prepopulate_id = (int) apply_filters( 'pods_gf_addon_prepopulate_id', $prepopulate_id, $feed['meta']['pod'], $form['id'], $feed, $form, $options, $pod );
- }
+ if ( 'user' === $pod->pod_data['type'] && is_user_logged_in() ) {
+ // Support user data editing
+ if ( 1 === (int) pods_v( 'enable_current_user', $feed['meta'], 0 ) ) {
+ $edit_id = get_current_user_id();
+ }
- if ( 0 < $edit_id ) {
- $options['edit'] = true;
+ // Support prepopulating
+ if ( 1 === (int) pods_v( 'enable_prepopulate', $feed['meta'], 0 ) ) {
+ $prepopulate = true;
- if ( $prepopulate ) {
- $options['prepopulate'] = true;
- }
+ $prepopulate_id = get_current_user_id();
+ }
+ } elseif ( in_array( $pod->pod_data['type'], array( 'post_type', 'media' ), true ) && is_singular( $pod->pod ) ) {
+ // Support post data editing
+ if ( 1 === (int) pods_v( 'enable_current_post', $feed['meta'], 0 ) ) {
+ $edit_id = get_the_ID();
+ }
- $pod->fetch( $edit_id );
- } elseif ( $prepopulate && 0 < $prepopulate_id ) {
- $options['prepopulate'] = true;
+ // Support prepopulating
+ if ( 1 === (int) pods_v( 'enable_prepopulate', $feed['meta'], 0 ) ) {
+ $prepopulate = true;
- $pod->fetch( $prepopulate_id );
- }
+ $prepopulate_id = get_the_ID();
+ }
+ }
- /**
- * Allow filtering of Pods GF options to set custom settings apart from Pods GF add-on options
- *
- * @param array $options Pods GF options
- * @param string $pod_name Pod name
- * @param int $form_id GF Form ID
- * @param array $feed GF Form feed array
- * @param array $form GF Form array
- * @param Pods $pod Pods object
- */
- $options = apply_filters( 'pods_gf_addon_options', $options, $feed['meta']['pod'], $form['id'], $feed, $form, $pod );
-
- pods_gf( $pod, $form['id'], $options );
-
- $setup[ $form['id'] ] = true;
+ /**
+ * Allow filtering of which item ID to use when editing (default none, always add new items)
+ *
+ * @param int $edit_id Edit ID
+ * @param string $pod_name Pod name
+ * @param int $form_id GF Form ID
+ * @param array $feed GF Form feed array
+ * @param array $form GF Form array
+ * @param array $options Pods GF options
+ * @param Pods $pod Pods object
+ */
+ $edit_id = (int) apply_filters( 'pods_gf_addon_edit_id', $edit_id, $feed['meta']['pod'], $form['id'], $feed, $form, $options, $pod );
+
+ /**
+ * Allow filtering of whether to prepopulate form fields (default none)
+ *
+ * @param bool $prepopulate Whether to prepopulate or not
+ * @param string $pod_name Pod name
+ * @param int $form_id GF Form ID
+ * @param array $feed GF Form feed array
+ * @param array $form GF Form array
+ * @param array $options Pods GF options
+ * @param Pods $pod Pods object
+ */
+ $prepopulate = (boolean) apply_filters( 'pods_gf_addon_prepopulate', $prepopulate, $feed['meta']['pod'], $form['id'], $feed, $form, $options, $pod );
+
+ if ( empty( $edit_id ) && $prepopulate ) {
+ /**
+ * Allow filtering of which item ID to use when prepopulating form fields (default is same as Edit ID)
+ *
+ * @param int $prepopulate_id ID to use when prepopulating
+ * @param string $pod_name Pod name
+ * @param int $form_id GF Form ID
+ * @param array $feed GF Form feed array
+ * @param array $form GF Form array
+ * @param array $options Pods GF options
+ * @param Pods $pod Pods object
+ */
+ $prepopulate_id = (int) apply_filters( 'pods_gf_addon_prepopulate_id', $prepopulate_id, $feed['meta']['pod'], $form['id'], $feed, $form, $options, $pod );
+ }
+
+ if ( 0 < $edit_id ) {
+ $options['edit'] = true;
+
+ if ( $prepopulate ) {
+ $options['prepopulate'] = true;
}
+
+ $pod->fetch( $edit_id );
+ } elseif ( $prepopulate && 0 < $prepopulate_id ) {
+ $options['prepopulate'] = true;
+
+ $pod->fetch( $prepopulate_id );
+ }
+
+ /**
+ * Allow filtering of Pods GF options to set custom settings apart from Pods GF add-on options
+ *
+ * @param array $options Pods GF options
+ * @param string $pod_name Pod name
+ * @param int $form_id GF Form ID
+ * @param array $feed GF Form feed array
+ * @param array $form GF Form array
+ * @param Pods $pod Pods object
+ */
+ $options = apply_filters( 'pods_gf_addon_options', $options, $feed['meta']['pod'], $form['id'], $feed, $form, $pod );
+
+ $this->pods_gf[ $feed['id'] ] = pods_gf( $pod, $form['id'], $options );
+
+ $setup[ $form['id'] ] = true;
+
+ return true;
+
+ }
+
+ /**
+ * Add custom merge tags for Pods GF.
+ *
+ * @param array $merge_tags Merge tags.
+ * @param int $form_id Form ID.
+ *
+ * @return array Merge tags,
+ */
+ public function _gf_custom_merge_tags( $merge_tags, $form_id ) {
+
+ $merge_tags[] = array(
+ 'tag' => '{pods:id}',
+ 'label' => esc_html__( 'Pods GF Item ID', 'pods-gravity-forms' ),
+ );
+
+ $merge_tags[] = array(
+ 'tag' => '{pods:permalink}',
+ 'label' => esc_html__( 'Pods GF Item Permalink', 'pods-gravity-forms' ),
+ );
+
+ return $merge_tags;
+
+ }
+
+ /**
+ * Add custom merge tags for Pods GF.
+ *
+ * @param array $data Merge tag data.
+ * @param string $text Content to replace custom merge tags in.
+ * @param false|array $form GF form object.
+ *
+ * @return array Merge tag data.
+ */
+ public function _gf_add_merge_tags( $data, $text, $form ) {
+
+ if ( empty( $form ) || empty( $form['id'] ) ) {
+ return $data;
+ }
+
+ $form_id = $form['id'];
+
+ $id = 0;
+ $permalink = '';
+
+ if ( ! empty( Pods_GF::$gf_to_pods_id[ $form_id ] ) ) {
+ $id = Pods_GF::$gf_to_pods_id[ $form_id ];
+ }
+
+ if ( ! empty( Pods_GF::$gf_to_pods_id[ $form_id . '_permalink' ] ) ) {
+ $permalink = Pods_GF::$gf_to_pods_id[ $form_id . '_permalink' ];
}
- return $form;
+ $data['pods'] = array(
+ 'id' => $id,
+ 'permalink' => $permalink,
+ );
+
+ return $data;
+
+ }
+
+ /**
+ * Replace custom merge tags in content for Pods GF.
+ *
+ * @param string $content Content to replace custom merge tags in.
+ * @param false|array $form GF form object.
+ *
+ * @return string Content with custom merge tags replaced.
+ */
+ public function _gf_replace_merge_tags( $content, $form ) {
+
+ if ( empty( $form ) || empty( $form['id'] ) ) {
+ return $content;
+ }
+
+ $form_id = $form['id'];
+
+ $id = 0;
+ $permalink = '';
+
+ if ( ! empty( Pods_GF::$gf_to_pods_id[ $form_id ] ) ) {
+ $id = Pods_GF::$gf_to_pods_id[ $form_id ];
+ }
+
+ if ( ! empty( Pods_GF::$gf_to_pods_id[ $form_id . '_permalink' ] ) ) {
+ $permalink = Pods_GF::$gf_to_pods_id[ $form_id . '_permalink' ];
+ }
+
+ // For backcompat purposes.
+ $id_merge_tags = array(
+ '{pods:id}',
+ '{gf_to_pods_id}',
+ '{@gf_to_pods_id}',
+ );
+
+ // For backcompat purposes.
+ $permalink_merge_tags = array(
+ '{pods:permalink}',
+ '{gf_to_pods_permalink}',
+ '{@gf_to_pods_permalink}',
+ );
+
+ $content = str_replace( $id_merge_tags, $id, $content );
+ $content = str_replace( $permalink_merge_tags, $permalink, $content );
+
+ return $content;
}
@@ -718,70 +1410,163 @@ public function _gf_pre_process( $form ) {
*/
public static function get_field_map_fields_with_custom_values( $feed, $field_name ) {
- $prefix = $field_name . '_';
- $custom_prefix = $prefix . 'override_custom_';
+ $prefix = $field_name . '_';
+
+ $old_custom_prefix = $prefix . 'override_custom_';
$fields = array();
- foreach ( $feed['meta'] as $config_field_name => $value ) {
+ $skip = array();
+
+ foreach ( $feed['meta'] as $config_field_name => $config ) {
$config_field_name = (string) $config_field_name;
+ $gf_field_custom = sprintf( '%s_custom', $config_field_name );
- if ( 0 === strpos( $config_field_name, $custom_prefix ) ) {
- // Skip override values
+ if ( in_array( $config_field_name, $skip, true ) ) {
continue;
- } elseif ( 0 === strpos( $config_field_name, $prefix ) ) {
- // Get field name
- $field_name = substr( $config_field_name, strlen( $prefix ) );
+ }
- // Mapping value is the GF field ID
- $gf_field = trim( $value );
+ if ( 0 === strpos( $config_field_name, $old_custom_prefix ) ) {
+ // Skip override values (old way)
+ continue;
+ }
- // Mapping value
- $mapping_value = array(
- 'gf_field' => $gf_field,
- 'field' => $field_name,
- );
+ if ( 0 !== strpos( $config_field_name, $prefix ) && $field_name !== $config_field_name ) {
+ continue;
+ }
- // Support override value settings
- if ( '_pods_custom' === $gf_field ) {
- $gf_field = sprintf( '_pods_gf_custom_%s', $field_name );
+ // Get field name
+ $field_name = substr( $config_field_name, strlen( $prefix ) );
- $mapping_value = array(
- 'gf_field' => $gf_field,
- 'field' => $field_name,
- 'value' => '',
- );
+ // Mapping value is the GF field ID
+ $gf_field = trim( $config );
+
+ // Mapping value
+ $mapping_value = array(
+ 'gf_field' => $gf_field,
+ 'field' => $field_name,
+ );
- if ( ! empty( $feed['meta'][ $custom_prefix ] ) ) {
- $value = trim( $feed['meta'][ $custom_prefix ] );
+ if ( 'gf_custom' === $gf_field ) {
+ // Support override value settings (new way)
+ $gf_field = sprintf( '_pods_gf_custom_%s', $field_name );
- if ( ! empty( $value ) ) {
- $mapping_value['value'] = $value;
- }
+ $mapping_value['gf_field'] = $gf_field;
+ $mapping_value['value'] = '';
+
+ if ( ! empty( $feed['meta'][ $gf_field_custom ] ) ) {
+ $value = trim( $feed['meta'][ $gf_field_custom ] );
+
+ if ( ! empty( $value ) ) {
+ $mapping_value['value'] = $value;
+
+ $mapping_value['gf_merge_tags'] = true;
}
}
+ } elseif ( '_pods_custom' === $gf_field ) {
+ // Support override value settings (old way)
+ $gf_field = sprintf( '_pods_gf_custom_%s', $field_name );
- if ( ! empty( $gf_field ) ) {
- $fields[] = $mapping_value;
+ $mapping_value['gf_field'] = $gf_field;
+ $mapping_value['value'] = '';
+
+ if ( ! empty( $feed['meta'][ $old_custom_prefix ] ) ) {
+ $value = trim( $feed['meta'][ $old_custom_prefix ] );
+
+ if ( ! empty( $value ) ) {
+ $mapping_value['value'] = $value;
+
+ $mapping_value['gf_merge_tags'] = true;
+ }
}
}
+
+ $skip[] = $gf_field_custom;
+
+ if ( ! empty( $gf_field ) ) {
+ $fields[] = $mapping_value;
+ }
}
return $fields;
}
+ /**
+ * Get field map field values with support for custom override values.
+ *
+ * This differs from get_field_map_fields() in that it returns an array
+ * that is already formatted for Pods GF field mapping usage.
+ *
+ * @param array $feed
+ *
+ * @return array
+ */
+ public static function get_field_map_custom_fields_with_custom_values( $feed ) {
+
+ if ( empty( $feed['meta']['custom_fields'] ) ) {
+ return array();
+ }
+
+ $configs = $feed['meta']['custom_fields'];
+
+ $fields = array();
+
+ foreach ( $configs as $config ) {
+ $config = array_map( 'trim', $config );
+
+ $gf_field = $config['value'];
+ $field_name = $config['key'];
+
+ if ( in_array( $field_name, array( 'gf_custom', '' ), true ) ) {
+ $field_name = $config['custom_key'];
+ }
+
+ // Mapping value
+ $mapping_value = array(
+ 'gf_field' => $gf_field,
+ 'field' => $field_name,
+ );
+
+ if ( in_array( $gf_field, array( 'gf_custom', '' ), true ) && ! empty( $config['custom_value'] ) ) {
+ $mapping_value['gf_field'] = sprintf( '_pods_gf_custom_%s', $field_name );
+ $mapping_value['value'] = $config['custom_value'];
+ $mapping_value['gf_merge_tags'] = true;
+ }
+
+ if ( '' === $mapping_value['gf_field'] || '' === $mapping_value['field'] ) {
+ continue;
+ }
+
+ $fields[] = $mapping_value;
+ }
+
+ return $fields;
+
+ }
+
+ /**
+ * @param array $entry_meta
+ * @param int $form_id
+ *
+ * @return array
+ */
public function get_entry_meta( $entry_meta, $form_id ) {
if ( $this->has_feed( $form_id ) ) {
- $entry_meta['pod_id'] = array(
- 'label' => 'Pod ID',
+ $entry_meta['_pods_item_id'] = array(
+ 'label' => 'Pod Item ID',
'is_numeric' => true,
'is_default_column' => true,
'update_entry_meta_callback' => array( $this, 'update_entry_meta_pod_id' ),
'filter' => array(
- 'operators' => array( 'is', 'isnot', '>', '<' )
- )
+ 'operators' => array(
+ 'is',
+ 'isnot',
+ '>',
+ '<',
+ ),
+ ),
);
}
@@ -789,6 +1574,13 @@ public function get_entry_meta( $entry_meta, $form_id ) {
}
+ /**
+ * @param $key
+ * @param $entry
+ * @param $form
+ *
+ * @return int
+ */
public function update_entry_meta_pod_id( $key, $entry, $form ) {
if ( ! empty( Pods_GF::$gf_to_pods_id[ $form['id'] ] ) ) {
diff --git a/includes/Pods_GF_CLI.php b/includes/Pods_GF_CLI.php
new file mode 100644
index 0000000..cbedbd2
--- /dev/null
+++ b/includes/Pods_GF_CLI.php
@@ -0,0 +1,128 @@
+
+ * : The Gravity Form ID.
+ *
+ * [--feed=]
+ * : The Gravity Form Pods Feed ID.
+ *
+ * ## EXAMPLES
+ *
+ * wp pods-gf sync --form=123 --feed=2
+ *
+ * @param $args
+ * @param $assoc_args
+ *
+ * @throws \WP_CLI\ExitException
+ */
+ public function sync( $args, $assoc_args ) {
+
+ add_filter( 'pods_gf_to_pods_update_pod_items', '__return_true' );
+
+ $form_id = 0;
+
+ if ( ! empty( $assoc_args['form'] ) ) {
+ $form_id = absint( $assoc_args['form'] );
+ }
+
+ if ( empty( $form_id ) ) {
+ \WP_CLI::error( esc_html__( 'Form ID is required.', 'pods-gravity-forms' ) );
+ }
+
+ $feed_id = 0;
+
+ if ( ! empty( $assoc_args['feed'] ) ) {
+ $feed_id = absint( $assoc_args['feed'] );
+ }
+
+ // Get form.
+ $form = \GFAPI::get_form( $form_id );
+
+ if ( empty( $form ) || is_wp_error( $form ) ) {
+ \WP_CLI::error( esc_html__( 'Form not found.', 'pods-gravity-forms' ) );
+ }
+
+ $active_only = true;
+
+ if ( 0 < $feed_id ) {
+ $active_only = false;
+ }
+
+ // Get feed.
+ $feeds = \GFAPI::get_feeds( $feed_id, $form_id, 'pods-gravity-forms', $active_only );
+
+ if ( empty( $feeds ) || is_wp_error( $feeds ) ) {
+ \WP_CLI::error( esc_html__( 'Feed not found.', 'pods-gravity-forms' ) );
+ }
+
+ // Use first feed.
+ $feed = reset( $feeds );
+
+ $feed_id = $feed['id'];
+
+ if ( empty( $feed_id ) ) {
+ \WP_CLI::error( esc_html__( 'Invalid feed.', 'pods-gravity-forms' ) );
+ }
+
+ /** @var Pods_GF_Addon $pods_gf_addon */
+ $pods_gf_addon = Pods_GF_Addon::get_instance();
+
+ $pods_gf_addon->setup_pods_gf( $form, $feed );
+
+ $pods_gf_addon->pods_gf[ $feed_id ]->options['update_pod_item'] = 1;
+
+ $total_entries = 0;
+
+ $search_criteria = array(
+ 'status' => 'active',
+ );
+
+ $paging = array(
+ 'offset' => 0,
+ 'page_size' => 50,
+ );
+
+ $entries = \GFAPI::get_entries( $form_id, $search_criteria, null, $paging, $total_entries );
+
+ /** @var \cli\progress\Bar $progress_bar */
+ /* translators: Total entries number is used in this message. */
+ $progress_bar = \WP_CLI\Utils\make_progress_bar( sprintf( esc_html_x( 'Syncing %s entries', 'Sync status message for WP-CLI feed sync using total entries count', 'pods-gravity-forms' ), number_format_i18n( $total_entries ) ), $total_entries );
+
+ $entries_counter = 0;
+
+ // Loop through all pages of entries and process feeds.
+ do {
+ // Loop through entries and process feed.
+ foreach ( $entries as $entry ) {
+ $pods_gf_addon->process_feed( $feed, $entry, $form );
+
+ Pods_GF::$actioned = [];
+
+ $progress_bar->tick();
+
+ $entries_counter++;
+ }
+
+ $paging['offset'] = $entries_counter;
+
+ $entries = \GFAPI::get_entries( $form_id, $search_criteria, null, $paging, $total_entries );
+ } while ( $entries );
+
+ $progress_bar->finish();
+
+ /* translators: Feed ID is used in this message. */
+ \WP_CLI::success( sprintf( esc_html_x( 'Form entries synced to Pods using feed %d.', 'Success message for WP-CLI feed sync using Feed ID', 'pods-gravity-forms' ), $feed_id ) );
+
+ }
+
+}
diff --git a/includes/Pods_GF_UI.php b/includes/Pods_GF_UI.php
index e6b0056..e5d6181 100755
--- a/includes/Pods_GF_UI.php
+++ b/includes/Pods_GF_UI.php
@@ -404,22 +404,22 @@ private function setup_ui() {
foreach ( $this->actions as $action => $options ) {
$this->actions[ $action ] = $options = array_merge( $defaults, $options );
- if ( !empty( $options[ 'heading' ] ) ) {
+ if ( !empty( $options[ 'heading' ] ) && empty( $this->ui[ 'heading' ][ $action ] ) ) {
$this->ui[ 'heading' ][ $action ] = $options[ 'heading' ];
}
- if ( !empty( $options[ 'header' ] ) ) {
+ if ( !empty( $options[ 'header' ] ) && empty( $this->ui[ 'header' ][ $action ] ) ) {
$this->ui[ 'header' ][ $action ] = $options[ 'header' ];
}
if ( !empty( $options[ 'label' ] ) ) {
$this->ui[ 'label' ][ $action ] = $options[ 'label' ];
- if ( !isset( $this->ui[ 'heading' ][ $action ] ) || empty( $this->ui[ 'heading' ][ $action ] ) ) {
+ if ( empty( $this->ui[ 'heading' ][ $action ] ) ) {
$this->ui[ 'heading' ][ $action ] = $options[ 'label' ];
}
- if ( !isset( $this->ui[ 'header' ][ $action ] ) || empty( $this->ui[ 'header' ][ $action ] ) ) {
+ if ( empty( $this->ui[ 'header' ][ $action ] ) ) {
$this->ui[ 'header' ][ $action ] = $options[ 'label' ];
}
@@ -818,6 +818,10 @@ public function access_constraints( $constraints ) {
public function _action_add( $obj ) {
self::$pods_ui =& $obj;
+
+ if ( $obj->restricted( $obj->action ) ) {
+ return false;
+ }
?>
icon ) { ?> style="background-position:0 0;background-size:100%;background-image:url(icon; ?>);">
@@ -825,7 +829,7 @@ public function _action_add( $obj ) {
header[ 'add' ];
- if ( !in_array( 'manage', $obj->actions_disabled ) && !in_array( 'manage', $obj->actions_hidden ) ) {
+ if ( !in_array( 'manage', $obj->actions_disabled ) && !in_array( 'manage', $obj->actions_hidden ) && ! $obj->restricted( 'manage' ) ) {
$link = pods_var_update( array( 'action' . $obj->num => 'manage', 'id' . $obj->num => '' ), PodsUI::$allowed, $obj->exclusion() );
if ( !empty( $obj->action_links[ 'manage' ] ) ) {
@@ -890,6 +894,10 @@ public function _action_edit( $duplicate, $obj = null ) {
return;
}
+
+ if ( $obj->restricted( $obj->action, $obj->row ) ) {
+ return $obj->error( sprintf( __( 'Error: You do not have access to this %s.', 'pods' ), $obj->item ) );
+ }
?>
icon ) { ?> style="background-position:0 0;background-size:100%;background-image:url(icon; ?>);">
@@ -897,7 +905,7 @@ public function _action_edit( $duplicate, $obj = null ) {
do_template( $duplicate ? $obj->header[ 'duplicate' ] : $obj->header[ $obj->action ] );
- if ( !in_array( 'manage', $obj->actions_disabled ) && !in_array( 'manage', $obj->actions_hidden ) ) {
+ if ( !in_array( 'manage', $obj->actions_disabled ) && !in_array( 'manage', $obj->actions_hidden ) && ! $obj->restricted( 'manage' ) ) {
$link = pods_var_update( array( 'action' . $obj->num => 'manage', 'id' . $obj->num => '' ), PodsUI::$allowed, $obj->exclusion() );
if ( !empty( $obj->action_links[ 'manage' ] ) ) {
@@ -952,6 +960,10 @@ public function _action_view( $obj = null ) {
return;
}
+
+ if ( $obj->restricted( $obj->action, $obj->row ) ) {
+ return false;
+ }
?>
icon ) { ?> style="background-position:0 0;background-size:100%;background-image:url(icon; ?>);">
@@ -959,7 +971,7 @@ public function _action_view( $obj = null ) {
do_template( $obj->header[ $obj->action ] );
- if ( !in_array( 'manage', $obj->actions_disabled ) && !in_array( 'manage', $obj->actions_hidden ) ) {
+ if ( !in_array( 'manage', $obj->actions_disabled ) && !in_array( 'manage', $obj->actions_hidden ) && ! $obj->restricted( 'manage' ) ) {
$link = pods_var_update( array( 'action' . $obj->num => 'manage', 'id' . $obj->num => '' ), PodsUI::$allowed, $obj->exclusion() );
if ( !empty( $obj->action_links[ 'manage' ] ) ) {
@@ -1003,6 +1015,10 @@ public function _action_delete( $id, $obj = null ) {
self::$pods_ui =& $obj;
+ if ( $obj->restricted( $obj->action, $obj->row ) ) {
+ return false;
+ }
+
if ( is_object( $this->pod ) ) {
return false; // continue as normal
}
@@ -1034,6 +1050,10 @@ public function _action_delete( $id, $obj = null ) {
public function _action_custom( $obj ) {
self::$pods_ui =& $obj;
+
+ if ( $obj->restricted( $obj->action, $obj->row ) ) {
+ return false;
+ }
?>
icon ) { ?> style="background-position:0 0;background-size:100%;background-image:url(icon; ?>);">
@@ -1041,7 +1061,7 @@ public function _action_custom( $obj ) {
header[ $this->action ];
- if ( !in_array( 'manage', $obj->actions_disabled ) && !in_array( 'manage', $obj->actions_hidden ) ) {
+ if ( !in_array( 'manage', $obj->actions_disabled ) && !in_array( 'manage', $obj->actions_hidden ) && ! $obj->restricted( 'manage' ) ) {
$link = pods_var_update( array( 'action' . $obj->num => 'manage', 'id' . $obj->num => '' ), PodsUI::$allowed, $obj->exclusion() );
if ( !empty( $obj->action_links[ 'manage' ] ) ) {
diff --git a/pods-gravity-forms.php b/pods-gravity-forms.php
index dfbd88d..d05b045 100755
--- a/pods-gravity-forms.php
+++ b/pods-gravity-forms.php
@@ -1,16 +1,15 @@
%s
',
- __( 'Pods Gravity Forms requires that the Pods and Gravity Forms core plugins be installed and activated.', 'pods-gravity-forms' )
- );
+ echo sprintf( '%s
', esc_html__( 'Pods Gravity Forms requires that the Pods and Gravity Forms core plugins be installed and activated.', 'pods-gravity-forms' ) );
}
}
-
/**
* Add Advanced Related Objects
*
@@ -122,6 +131,7 @@ function pods_gf_add_related_objects() {
);
}
+
add_action( 'pods_form_ui_field_pick_related_objects_other', 'pods_gf_add_related_objects' );
/**
@@ -148,11 +158,7 @@ function pods_gf_add_related_objects_forms( $name = null, $value = null, $option
$form_title = $form->title;
if ( 1 !== (int) $form->is_active ) {
- $form_title = sprintf(
- '%s (%s)',
- $form_title,
- __( 'inactive', 'pods-gravity-forms' )
- );
+ $form_title = sprintf( '%s (%s)', $form_title, __( 'inactive', 'pods-gravity-forms' ) );
}
$data[ $form->id ] = $form_title;
@@ -160,4 +166,4 @@ function pods_gf_add_related_objects_forms( $name = null, $value = null, $option
return apply_filters( 'pods_form_ui_field_pick_' . __FUNCTION__, $data, $name, $value, $options, $pod, $id );
-}
\ No newline at end of file
+}
diff --git a/readme.txt b/readme.txt
index a0c60ae..ca6414d 100755
--- a/readme.txt
+++ b/readme.txt
@@ -2,9 +2,9 @@
Contributors: sc0ttkclark, jimtrue, naomicbush, gravityplus
Donate link: https://pods.io/friends-of-pods/
Tags: pods, gravity forms, form mapping
-Requires at least: 4.0
-Tested up to: 4.8
-Stable tag: 1.3
+Requires at least: 4.6
+Tested up to: 4.9.8
+Stable tag: 1.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
@@ -20,6 +20,86 @@ Please report bugs or request featured on [GitHub](https://github.com/pods-frame
Special thanks to Rocketgenius for their sponsorship support and to Naomi C. Bush for her help in the initial add-on UI work.
+= WP-CLI Command for Syncing Entries =
+
+This add-on provides the ability to sync entries from a Form Submission and Entry Edit screen. To bulk sync all entries even prior to setting up a Pods Gravity Form Feed, you can run a WP-CLI command.
+
+**Example 1: Sync all entries for Form 123 first active Pod feed**
+
+`wp pods-gf sync --form=123`
+
+**Example 2: Sync all entries for Form 123 using a specific feed (even if it is inactive)**
+
+`wp pods-gf sync --form=123 --feed=2`
+
+= Mapping GF List Fields to a Pods Relationship field =
+
+You can map a GF List field to a Relationship field related to another Pod. Using the below examples you can customize how the automatic mapping works. By default, the list columns will map to the pod fields with the same labels.
+
+**Example 1: Customize what columns map to which Related Pod fields for Form ID 1, Field ID 2**
+
+Customizing a list field row can be done by using the `pods_gf_field_columns_mapping` filter, which has Form ID and Field ID variations (`pods_gf_field_columns_mapping_{form_id}` and `pods_gf_field_columns_mapping_{form_id}_{field_id}`).
+
+`
+add_filter( 'pods_gf_field_columns_mapping_1_2', 'my_columns_mapping', 10, 4 );
+
+/**
+ * Filter list columns mapping for related pod fields.
+ *
+ * @param array $columns List field columns.
+ * @param array $form GF form.
+ * @param GF_Field $gf_field GF field data.
+ * @param Pods $pod Pods object.
+ *
+ * @return array
+ */
+function my_columns_mapping( $columns, $form, $gf_field, $related_obj ) {
+
+ $columns[0] = 'first_field';
+ $columns[1] = 'second_field';
+ $columns[2] = 'third_field';
+
+ return $columns;
+
+}
+`
+
+**Example 2: Customize a List row for Form ID 1, Field ID 2**
+
+Customizing a list field row can be done by using the `pods_gf_field_column_row` filter, which has Form ID and Field ID variations (`pods_gf_field_column_row_{form_id}` and `pods_gf_field_column_row_{form_id}_{field_id}`).
+
+`
+add_filter( 'pods_gf_field_column_row_1_2', 'my_column_row_override', 10, 6 );
+
+/**
+ * Filter list field row for relationship field saving purposes.
+ *
+ * @param array $row List field row.
+ * @param array $columns List field columns.
+ * @param array $form GF form.
+ * @param GF_Field $gf_field GF field data.
+ * @param array $options Pods GF options.
+ * @param Pods|false $related_obj Related Pod object.
+ *
+ * @return array
+ */
+function my_column_row_override( $row, $columns, $form, $gf_field, $options, $related_obj ) {
+
+ // Update certain row fields based on the value of specific column.
+ if ( ! empty( $row['user_relationship_field'] ) ) {
+ $user = get_userdata( (int) $row['user'] );
+
+ // Set the post_title to match the User display name.
+ if ( $user && ! is_wp_error( $user ) ) {
+ $row['post_title'] = $user->display_name;
+ }
+ }
+
+ return $row;
+
+}
+`
+
== Screenshots ==
1. In the Pods Admin, create your Pods and Pod Fields: Pods Admin -> Add New
@@ -34,6 +114,39 @@ Special thanks to Rocketgenius for their sponsorship support and to Naomi C. Bus
== Changelog ==
+= 1.4 - October 16th, 2018 =
+
+* Support: Added support for Gravity Forms 2.3 database tables changes (You may see a warning on the Edit Pod screen but this is a false positive because we cache a list of all tables to transients and it triggers the warning solved by removing those old "rg" tables)
+* Changed: Backwards compatibility issue -- You can now more easily set custom override values, however the old style was not able to be brought over -- you'll want to update your feeds when possible, the old values will not show up and you'll have to select the custom override value option once more, then fill it in
+* Changed: Backwards compatibility issue -- Now requiring WordPress 4.6+
+* Feature: When editing entries in the admin area, changes now sync to the associated Pod item (except trash/deletes)
+* Feature: New Bulk Entry Syncing to Pods WP-CLI command `wp pods-gf sync --form=123` or you can specify which feed (even if it is not active) with `wp pods-gf sync --form=123 --feed=2`
+* Feature: Support for List field mapping to a Pod field which ends up serializing the value, but can be prepopulated back into the Gravity Form
+* Feature: List field mapping to relationship fields related to another Pod (list columns map to individual fields in the related Pod) with new filters `pods_gf_field_columns_mapping` and `pods_gf_field_column_row`
+* Feature: Support for Chained Select field mapping to a Pod field
+* Feature: New Custom fields section added for Pods that support meta (Posts, Terms, Users, Media, and Comments), you can set additional custom fields including ability to set custom values there too
+* Feature: Ability to set conditional processing per feed, based on specific values submitted
+* Added: Whenever you create a new feed, mapping will automatically be associated between a Gravity Form field and a Pod field if the labels match
+* Added: Custom override values now support GF merge tags by default (no insert UI yet) like `{form_id}` and any other merge tag
+* Added: Required WP Object Fields in mapping are no longer required if you choose to 'Enable editing with this form using ____' option for Post/Media or User pod types
+* Added: Support for E-mail field mappings with 'Confirm E-mail' enabled
+* Added: Support for Date fields with multiple inputs (date dropdown / text fields)
+* Added: Smarter requirement handling for WP object fields based on object type (only require what the WP insert API requires)
+* Added: New mapping fields are now available for more Entry and Payment fields
+* Added: New merge tags `{pods.id}` and `{pods.permalink}` are available for usage and in the merge tag selection dropdowns
+* Improved: Added headings to each group of feed options so they are easier to work with
+* Improved: Address field mapping for Country, State, and CA Provinces now convert properly to their Pods counterparts
+* Updated: PHP Markdown library updated to 1.0.2
+* Fixed: Issues with using 'bypass' as a save action
+* Fixed: Dynamic select options should set the current value (as posted in form) properly
+* Fixed: Date/time fields shouldn't auto populate with empty dates such as 0000-00-00 anymore
+* Fixed: Additional attachment processing fixes
+* Fixed: Lots of Pods GF UI issues resolved
+* Fixed: Removed Autocomplete limit (was 30) that was being enforced, now all data from related field will show
+* Fixed: Dynamic mapping value checking to support arrays of values
+* Fixed: Lots of Prepopulating fixes
+* Fixed: Now supports multi page form validation and prepopulating
+
= 1.3 - June 2nd, 2017 =
* Added: When creating new feeds mapping will automatically be detected based on matching field labels
diff --git a/tests/_bootstrap.php b/tests/_bootstrap.php
new file mode 100644
index 0000000..358203e
--- /dev/null
+++ b/tests/_bootstrap.php
@@ -0,0 +1,7 @@
+esc_like( $wpdb->prefix . 'rg_' ) . '%',
+ $wpdb->esc_like( $wpdb->prefix . 'gf_' ) . '%',
+ $wpdb->esc_like( $wpdb->prefix . 'pods' ) . '%',
+ $wpdb->esc_like( $wpdb->prefix . 'post' ) . '%',
+ $wpdb->esc_like( $wpdb->prefix . 'term' ) . '%',
+ ];
+
+ $tables = $wpdb->get_col( $wpdb->prepare( $sql, $prepare ) );
+
+ foreach ( $tables as $table ) {
+ $wpdb->query( "TRUNCATE `{$table}`" );
+ }
+
+ pods_init()->reset();
+ }
+
+ if ( $rebuild_data ) {
+ wp_set_current_user( 1 );
+
+ // do setup
+ self::setup_forms();
+
+ echo "\nData rebuilt, you can now export the updated SQL to tests/_data/test-data.sql\n";
+ die();
+ }
+
+ }
+
+ /**
+ * Helper for after running each test.
+ */
+ public static function after_test() {
+
+ /**
+ * @var $wpdb \wpdb
+ */
+ global $wpdb;
+
+ $wpdb->show_errors( true );
+ $wpdb->suppress_errors( false );
+
+ // Clear sessions/cookies
+ \WP_User_Meta_Session_Tokens::drop_sessions();
+
+ wp_set_current_user( 0 );
+
+ $_SESSION = [];
+ $_COOKIE = [];
+
+ // Clear caches
+ global $wp_object_cache;
+
+ $wpdb->queries = [];
+
+ if ( is_object( $wp_object_cache ) ) {
+ $wp_object_cache->group_ops = [];
+ $wp_object_cache->stats = [];
+ $wp_object_cache->memcache_debug = [];
+
+ // Make sure this is a public property, before trying to clear it
+ try {
+ $cache_property = new \ReflectionProperty( $wp_object_cache, 'cache' );
+ if ( $cache_property->isPublic() ) {
+ $wp_object_cache->cache = [];
+ }
+ unset( $cache_property );
+ } catch ( \ReflectionException $e ) {
+ }
+
+ /*
+ * In the case where we're not using an external object cache, we need to call flush on the default
+ * WordPress object cache class to clear the values from the cache property
+ */
+ if ( ! wp_using_ext_object_cache() ) {
+ wp_cache_flush();
+ }
+
+ if ( is_callable( $wp_object_cache, '__remoteset' ) ) {
+ call_user_func( [ $wp_object_cache, '__remoteset' ] ); // important
+ }
+ } else {
+ wp_cache_flush();
+ }
+
+ }
+
+ /**
+ * Get mapping config.
+ *
+ * @return array
+ */
+ public static function get_mapping_config() {
+
+ $mapping_config = array(
+ array(
+ 'gf_type' => 'text',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'text',
+ 'pod_type' => 'password',
+ ),
+ array(
+ 'gf_type' => 'text',
+ 'pod_type' => 'website',
+ ),
+ array(
+ 'gf_type' => 'text',
+ 'pod_type' => 'phone',
+ ),
+ array(
+ 'gf_type' => 'text',
+ 'pod_type' => 'email',
+ ),
+ array(
+ 'gf_type' => 'text',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'text',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'text',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'text',
+ 'pod_type' => 'datetime',
+ ),
+ array(
+ 'gf_type' => 'text',
+ 'pod_type' => 'date',
+ ),
+ array(
+ 'gf_type' => 'text',
+ 'pod_type' => 'time',
+ ),
+ array(
+ 'gf_type' => 'text',
+ 'pod_type' => 'number',
+ ),
+ array(
+ 'gf_type' => 'text',
+ 'pod_type' => 'currency',
+ ),
+ array(
+ 'gf_type' => 'text',
+ 'pod_type' => 'oembed',
+ ),
+ array(
+ 'gf_type' => 'text',
+ 'pod_type' => 'boolean',
+ ),
+ array(
+ 'gf_type' => 'text',
+ 'pod_type' => 'color',
+ ),
+ array(
+ 'gf_type' => 'text + enablePasswordInput=1',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'text + enablePasswordInput=1',
+ 'pod_type' => 'password',
+ ),
+ array(
+ 'gf_type' => 'textarea',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'textarea',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'textarea',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'textarea',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'textarea + useRichTextEditor=1',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'textarea + useRichTextEditor=1',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'textarea + useRichTextEditor=1',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'textarea + useRichTextEditor=1',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'select',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'select',
+ 'pod_type' => 'website',
+ ),
+ array(
+ 'gf_type' => 'select',
+ 'pod_type' => 'phone',
+ ),
+ array(
+ 'gf_type' => 'select',
+ 'pod_type' => 'email',
+ ),
+ array(
+ 'gf_type' => 'select',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'select',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'select',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'select',
+ 'pod_type' => 'datetime',
+ ),
+ array(
+ 'gf_type' => 'select',
+ 'pod_type' => 'date',
+ ),
+ array(
+ 'gf_type' => 'select',
+ 'pod_type' => 'time',
+ ),
+ array(
+ 'gf_type' => 'select',
+ 'pod_type' => 'number',
+ ),
+ array(
+ 'gf_type' => 'select',
+ 'pod_type' => 'currency',
+ ),
+ array(
+ 'gf_type' => 'select',
+ 'pod_type' => 'oembed',
+ ),
+ array(
+ 'gf_type' => 'select',
+ 'pod_type' => 'pick',
+ ),
+ array(
+ 'gf_type' => 'select',
+ 'pod_type' => 'boolean',
+ ),
+ array(
+ 'gf_type' => 'select',
+ 'pod_type' => 'color',
+ ),
+ array(
+ 'gf_type' => 'multiselect',
+ 'pod_type' => 'pick',
+ ),
+ array(
+ 'gf_type' => 'number',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'number',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'number',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'number',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'number',
+ 'pod_type' => 'number',
+ ),
+ array(
+ 'gf_type' => 'number',
+ 'pod_type' => 'currency',
+ ),
+ array(
+ 'gf_type' => 'number',
+ 'pod_type' => 'pick',
+ ),
+ array(
+ 'gf_type' => 'checkbox',
+ 'pod_type' => 'pick',
+ ),
+ array(
+ 'gf_type' => 'radio',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'radio',
+ 'pod_type' => 'website',
+ ),
+ array(
+ 'gf_type' => 'radio',
+ 'pod_type' => 'phone',
+ ),
+ array(
+ 'gf_type' => 'radio',
+ 'pod_type' => 'email',
+ ),
+ array(
+ 'gf_type' => 'radio',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'radio',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'radio',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'radio',
+ 'pod_type' => 'datetime',
+ ),
+ array(
+ 'gf_type' => 'radio',
+ 'pod_type' => 'date',
+ ),
+ array(
+ 'gf_type' => 'radio',
+ 'pod_type' => 'time',
+ ),
+ array(
+ 'gf_type' => 'radio',
+ 'pod_type' => 'number',
+ ),
+ array(
+ 'gf_type' => 'radio',
+ 'pod_type' => 'currency',
+ ),
+ array(
+ 'gf_type' => 'radio',
+ 'pod_type' => 'oembed',
+ ),
+ array(
+ 'gf_type' => 'radio',
+ 'pod_type' => 'pick',
+ ),
+ array(
+ 'gf_type' => 'radio',
+ 'pod_type' => 'boolean',
+ ),
+ array(
+ 'gf_type' => 'radio',
+ 'pod_type' => 'color',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'password',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'website',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'phone',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'email',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'datetime',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'date',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'time',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'number',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'currency',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'oembed',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'pick',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'boolean',
+ ),
+ array(
+ 'gf_type' => 'hidden',
+ 'pod_type' => 'color',
+ ),
+ array(
+ 'gf_type' => 'name',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'name',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'name',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'name',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'date + dateType=datefield',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'date + dateType=datefield',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'date + dateType=datefield',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'date + dateType=datefield',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'date + dateType=datefield',
+ 'pod_type' => 'date',
+ ),
+ array(
+ 'gf_type' => 'date + dateType=datepicker',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'date + dateType=datepicker',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'date + dateType=datepicker',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'date + dateType=datepicker',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'date + dateType=datepicker',
+ 'pod_type' => 'date',
+ ),
+ array(
+ 'gf_type' => 'date + dateType=datedropdown',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'date + dateType=datedropdown',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'date + dateType=datedropdown',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'date + dateType=datedropdown',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'date + dateType=datedropdown',
+ 'pod_type' => 'date',
+ ),
+ array(
+ 'gf_type' => 'time + timeFormat=12',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'time + timeFormat=12',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'time + timeFormat=12',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'time + timeFormat=12',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'time + timeFormat=12',
+ 'pod_type' => 'time',
+ ),
+ array(
+ 'gf_type' => 'time + timeFormat=24',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'time + timeFormat=24',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'time + timeFormat=24',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'time + timeFormat=24',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'time + timeFormat=24',
+ 'pod_type' => 'time',
+ ),
+ array(
+ 'gf_type' => 'phone',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'phone',
+ 'pod_type' => 'phone',
+ ),
+ array(
+ 'gf_type' => 'phone',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'phone',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'phone',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'address',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'address',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'address',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'address',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'website',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'website',
+ 'pod_type' => 'website',
+ ),
+ array(
+ 'gf_type' => 'website',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'website',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'website',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'email',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'email',
+ 'pod_type' => 'email',
+ ),
+ array(
+ 'gf_type' => 'email',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'email',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'email',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'fileupload',
+ 'pod_type' => 'file',
+ ),
+ array(
+ 'gf_type' => 'list',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'list',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'list',
+ 'pod_type' => 'pick',
+ ),
+ array(
+ 'gf_type' => 'postcreation_post_title',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'postcreation_post_title',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'postcreation_post_title',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'postcreation_post_title',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'postcreation_post_content',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'postcreation_post_content',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'postcreation_post_content',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'postcreation_post_content',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'postcreation_post_excerpt',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'postcreation_post_excerpt',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'postcreation_post_excerpt',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'postcreation_post_excerpt',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'product',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'product',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'product',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'product',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'quantity',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'quantity',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'quantity',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'quantity',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'quantity',
+ 'pod_type' => 'number',
+ ),
+ array(
+ 'gf_type' => 'quantity',
+ 'pod_type' => 'currency',
+ ),
+ array(
+ 'gf_type' => 'option',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'option',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'option',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'option',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'shipping',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'shipping',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'shipping',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'shipping',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'shipping',
+ 'pod_type' => 'number',
+ ),
+ array(
+ 'gf_type' => 'shipping',
+ 'pod_type' => 'currency',
+ ),
+ array(
+ 'gf_type' => 'total',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'total',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'total',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'total',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'total',
+ 'pod_type' => 'number',
+ ),
+ array(
+ 'gf_type' => 'total',
+ 'pod_type' => 'currency',
+ ),
+ array(
+ 'gf_type' => 'entry_id',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'entry_id',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'entry_id',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'entry_id',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'entry_id',
+ 'pod_type' => 'number',
+ ),
+ array(
+ 'gf_type' => 'entry_date',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'entry_date',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'entry_date',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'entry_date',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'entry_date',
+ 'pod_type' => 'datetime',
+ ),
+ array(
+ 'gf_type' => 'entry_date',
+ 'pod_type' => 'date',
+ ),
+ array(
+ 'gf_type' => 'user_agent',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'user_agent',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'user_agent',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'user_agent',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'ip',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'ip',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'ip',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'ip',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'source_url',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'source_url',
+ 'pod_type' => 'website',
+ ),
+ array(
+ 'gf_type' => 'source_url',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'source_url',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'source_url',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'transaction_id',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'transaction_id',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'transaction_id',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'transaction_id',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'transaction_id',
+ 'pod_type' => 'number',
+ ),
+ array(
+ 'gf_type' => 'payment_amount',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'payment_amount',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'payment_amount',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'payment_amount',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'payment_amount',
+ 'pod_type' => 'number',
+ ),
+ array(
+ 'gf_type' => 'payment_amount',
+ 'pod_type' => 'currency',
+ ),
+ array(
+ 'gf_type' => 'payment_date',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'payment_date',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'payment_date',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'payment_date',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'payment_date',
+ 'pod_type' => 'datetime',
+ ),
+ array(
+ 'gf_type' => 'payment_date',
+ 'pod_type' => 'date',
+ ),
+ array(
+ 'gf_type' => 'payment_status',
+ 'pod_type' => 'text',
+ ),
+ array(
+ 'gf_type' => 'payment_status',
+ 'pod_type' => 'paragraph',
+ ),
+ array(
+ 'gf_type' => 'payment_status',
+ 'pod_type' => 'wysiwyg',
+ ),
+ array(
+ 'gf_type' => 'payment_status',
+ 'pod_type' => 'code',
+ ),
+ array(
+ 'gf_type' => 'payment_status',
+ 'pod_type' => 'pick',
+ ),
+ );
+
+ return $mapping_config;
+
+ }
+
+ /**
+ * Setup test forms.
+ */
+ public static function setup_forms() {
+
+ $mapping_config = self::get_mapping_config();
+
+ $pods = array();
+
+ $form_meta = array(
+ 'title' => 'Test form',
+ );
+
+ \GFAPI::add_form( $form_meta );
+
+ $gf_fields = array();
+ $pod_fields = array();
+
+ foreach ( $mapping_config as $config ) {
+
+ }
+
+ }
+
+ /**
+ * Short-circuits calls to the `wp_remote_post` and `wp_remote_get` functions and sets expectations on their call
+ * arguments.
+ *
+ * @param WPTestCase $test_case Test case.
+ * @param null|int $expected_times The number of times the `wp_remote_post` function is expected to be called;
+ * passing `null` here means the function will be simply short-circuited.
+ * @param array $expected_urls An array of expected URLs for each call; the first one will be matched to the
+ * first, the second one to the second call and so on; empty values will not be
+ * matched.
+ * @param mixed $return The response return value; defaults to `false`.
+ */
+ public static function mock_wp_remote_call( $test_case, $expected_times = null, array $expected_urls = [], $return = false ) {
+ add_filter( 'pre_http_request', function ( $block, $r, $url ) use ( $expected_times, $expected_urls, $return ) {
+ static $times;
+ $times = null === $times ? 1 : ++ $times;
+
+ if ( ! empty( $expected_urls[ $times - 1 ] ) ) {
+ $expected_url = $expected_urls[ $times - 1 ];
+ if ( $expected_url !== $url ) {
+ $message = "Expected '{$expected_url}' at call {$times}; got '{$url}'";
+ throw new \Exception( $message );
+ }
+ }
+
+ if ( 0 < $expected_times ) {
+ if ( $times === $expected_times ) {
+ throw new MockedCall();
+ }
+ }
+
+ return $return;
+ }, 1, 3 );
+
+ if ( null !== $expected_times ) {
+ $test_case->expectException( MockedCall::class );
+ }
+ }
+
+}
diff --git a/tests/_support/_generated/.gitignore b/tests/_support/_generated/.gitignore
new file mode 100644
index 0000000..c96a04f
--- /dev/null
+++ b/tests/_support/_generated/.gitignore
@@ -0,0 +1,2 @@
+*
+!.gitignore
\ No newline at end of file
diff --git a/tests/_support/travis/build.sh b/tests/_support/travis/build.sh
new file mode 100755
index 0000000..6ffeb69
--- /dev/null
+++ b/tests/_support/travis/build.sh
@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+# Created from the .travis.yml file
+# Last update 2018-08-20
+# Update this file when/if updating the .travis.yml file removing the lines that would run the tests: the script part.
+# Used in Travis CI debug simply by calling it like this from the $TRAVIS_BUILD_DIR folder
+# cd $TRAVIS_BUILD_DIR && sh ./tests/travis/build.sh
+
+cd $TRAVIS_BUILD_DIR
+
+export wpDbName="wordpress" wpLoaderDbName="wordpress" wpDbPrefix="wp_" wpAdminUsername="admin" wpAdminPassword="admin" wpRootFolder="/tmp/wordpress"
+
+# set up DB
+mysql -e "CREATE DATABASE IF NOT EXISTS $wpDbName;" -uroot
+mysql -e "CREATE DATABASE IF NOT EXISTS $wpLoaderDbName;" -uroot
+
+if [ ! -d "$wpRootFolder" ]; then
+ # set up folders
+ mkdir -p $HOME/tools $wpRootFolder
+
+ # install wp-cli
+ wget https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar -P /tmp/tools/
+ chmod +x /tmp/tools/wp-cli.phar && mv /tmp/tools/wp-cli.phar /tmp/tools/wp
+ export PATH=$PATH:/tmp/tools:vendor/bin
+
+ # install Apache and WordPress setup scripts
+ git clone https://github.com/lucatume/travis-apache-setup.git /tmp/tools/travis-apache-setup
+ chmod +x /tmp/tools/travis-apache-setup/apache-setup.sh
+ chmod +x /tmp/tools/travis-apache-setup/wp-install.sh
+ ln -s /tmp/tools/travis-apache-setup/apache-setup.sh /tmp/tools/apache-setup
+ ln -s /tmp/tools/travis-apache-setup/wp-install.sh /tmp/tools/wp-install
+
+ # download and install WordPress
+ if [ $wpMultisite = "1" ]; then
+ wp-install --dir="$wpRootFolder" --dbname="$wpDbName" --dbuser="root" --dbpass="" --dbprefix="$wpDbPrefix" --multisite --subdomains --domain="$wpUrl" --title="Test" --admin_user="$wpAdminUsername" --admin_password="$wpAdminPassword" --admin_email="admin@$wpUrl" --theme="twentysixteen" --empty
+ fi
+
+ if [ $wpMultisite = "0" ]; then
+ wp-install --dir="$wpRootFolder" --dbname="$wpDbName" --dbuser="root" --dbpass="" --dbprefix="$wpDbPrefix" --domain="$wpUrl" --title="Test" --admin_user="$wpAdminUsername" --admin_password="$wpAdminPassword" --admin_email="admin@$wpUrl" --theme="twentysixteen" --empty
+ fi
+fi
+
+if [ ! -d "$wpRootFolder/wp-content/$pluginsFolder" ]; then
+ # make the folder if it needs to be made
+ mkdir $wpRootFolder/wp-content/$pluginsFolder
+fi
+
+# move the plugin into WordPress folder
+mv $TRAVIS_BUILD_DIR/wp-content/$pluginsFolder/$pluginSlug $wpRootFolder/wp-content/$pluginsFolder/$pluginSlug
+
+# set up Apache virtual host
+sudo env "PATH=$PATH" apache-setup --host="127.0.0.1" --url="$wpUrl" --dir="$wpRootFolder"
+
+# get back to the plugin dir
+cd $wpRootFolder/wp-content/$pluginsFolder/$pluginSlug
+
+# update composer
+composer update --prefer-dist
+
+if [ $pluginsFolder = "plugins" ]; then
+ # activate the plugin in WordPress now that we have all dependencies
+ wp plugin activate $pluginSlug --path=$wpRootFolder
+fi
+
+# flush rewrite rules
+printf "apache_modules:\n\t- mod_rewrite" > $wpRootFolder/wp-cli.yml
+wp rewrite structure '/%postname%/' --hard --path=$wpRootFolder
diff --git a/tests/config.php b/tests/config.php
new file mode 100644
index 0000000..b3d9bbc
--- /dev/null
+++ b/tests/config.php
@@ -0,0 +1 @@
+assertTrue( true );
+
+ }
+
+}
diff --git a/tests/integration/_bootstrap.php b/tests/integration/_bootstrap.php
new file mode 100644
index 0000000..a4abe2d
--- /dev/null
+++ b/tests/integration/_bootstrap.php
@@ -0,0 +1,2 @@
+