first commit

wp-content/plugins/mailchimp-for-wp/includes/forms/functions.php

@@ -0,0 +1,127 @@
+<?php
+
+/**
+ * Returns a Form instance
+ *
+ * @access public
+ *
+ * @param int|WP_Post $form_id.
+ *
+ * @return MC4WP_Form
+ */
+function mc4wp_get_form( $form_id = 0 ) {
+	return MC4WP_Form::get_instance( $form_id );
+}
+
+/**
+ * Get an array of Form instances
+ *
+ * @access public
+ *
+ * @param array $args Array of parameters
+ *
+ * @return MC4WP_Form[]
+ */
+function mc4wp_get_forms( array $args = array() ) {
+	// parse function arguments
+	$default_args      = array(
+		'post_status'         => 'publish',
+		'posts_per_page'      => -1,
+		'ignore_sticky_posts' => true,
+		'no_found_rows'       => true,
+	);
+	$args              = array_merge( $default_args, $args );
+
+	// set post_type here so it can't be overwritten using function arguments
+	$args['post_type'] = 'mc4wp-form';
+
+	$q                 = new WP_Query();
+	$posts             = $q->query( $args );
+	$forms = array();
+	foreach ( $posts as $post ) {
+		try {
+			$form = mc4wp_get_form( $post );
+		} catch ( Exception $e ) {
+			continue;
+		}
+
+		$forms[] = $form;
+	}
+	return $forms;
+}
+
+/**
+ * Echoes the given form
+ *
+ * @access public
+ *
+ * @param int $form_id
+ * @param array $config
+ * @param bool $echo
+ *
+ * @return string
+ */
+function mc4wp_show_form( $form_id = 0, $config = array(), $echo = true ) {
+	/** @var MC4WP_Form_Manager $forms */
+	$forms = mc4wp( 'forms' );
+	return $forms->output_form( $form_id, $config, $echo );
+}
+
+/**
+ * Check whether a form was submitted
+ *
+ * @ignore
+ * @since 2.3.8
+ * @deprecated 3.0
+ * @use mc4wp_get_form
+ *
+ * @param int $form_id The ID of the form you want to check. (optional)
+ * @param string $element_id The ID of the form element you want to check, eg id="mc4wp-form-1" (optional)
+ *
+ * @return boolean
+ */
+function mc4wp_form_is_submitted( $form_id = 0, $element_id = null ) {
+	try {
+		$form = mc4wp_get_form( $form_id );
+	} catch ( Exception $e ) {
+		return false;
+	}
+
+	if ( $element_id ) {
+		$form_element = new MC4WP_Form_Element( $form, array( 'element_id' => $element_id ) );
+		return $form_element->is_submitted;
+	}
+
+	return $form->is_submitted;
+}
+
+/**
+ * @since 2.3.8
+ * @deprecated 3.0
+ * @ignore
+ * @use mc4wp_get_form
+ *
+ * @param int $form_id (optional)
+ *
+ * @return string
+ */
+function mc4wp_form_get_response_html( $form_id = 0 ) {
+	try {
+		$form = mc4wp_get_form( $form_id );
+	} catch ( Exception $e ) {
+		return '';
+	}
+
+	return $form->get_response_html();
+}
+
+/**
+ * Gets an instance of the submitted form, if any.
+ *
+ * @access public
+ *
+ * @return MC4WP_Form|null
+ */
+function mc4wp_get_submitted_form() {
+	return mc4wp( 'forms' )->get_submitted_form();
+}