Files
DESKTOP-GBA0BK8\Admin 7c8c8b1c76 first commit
2023-04-08 12:19:53 -04:00

129 lines
2.4 KiB
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();
}