Current File : /home/aventura/www/site/wp-content/plugins/mailchimp-for-wp/includes/forms/functions.php |
<?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
* @uses get_posts
*
* @param array $args Array of parameters
*
* @return MC4WP_Form[]
*/
function mc4wp_get_forms( array $args = array() ) {
$default_args = array(
'post_status' => 'publish',
'numberposts' => -1,
);
$args = array_merge( $default_args, $args );
$args['post_type'] = 'mc4wp-form';
$posts = get_posts( $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();
}