html-forms / src / functions.php

functions.php in HTML Forms – Simple WordPress Forms Plugin 1.0.4, at src/functions.php

159 lines 4.4 KB

Raw Download Zip

1	<?php
2
3	use HTML_Forms\Form;
4	use HTML_Forms\Submission;
5
6	/**
7	* @param $form_id_or_slug int\|string
8	* @return Form
9	* @throws Exception
10	*/
11	function hf_get_form( $form_id_or_slug ) {
12
13	if( is_numeric( $form_id_or_slug ) ) {
14	$post = get_post( $form_id_or_slug );
15
16	if( ! $post \|\| $post->post_type !== 'html-form' ) {
17	throw new Exception( "Invalid form ID" );
18	}
19	} else {
20	$posts = get_posts(
21	array(
22	'post_type' => 'html-form',
23	'name' => $form_id_or_slug,
24	'post_status' => 'publish',
25	'numberposts' => 1,
26	)
27	);
28
29	if( empty( $posts ) ) {
30	throw new Exception( 'Invalid form slug' );
31	}
32	$post = $posts[0];
33	}
34
35	static $default_messages;
36	if( $default_messages === null ) {
37	$default_messages = array(
38	'success' => __('Thank you! We will be in touch soon.', 'html-forms'),
39	'invalid_email' => __( 'Sorry, that email address looks invalid.', 'html-forms' ),
40	'required_field_missing' => __( "Please fill in the required fields.", "html-forms" ),
41	'error' => __( 'Oops. An error occurred.', 'html-forms' ),
42	);
43	}
44
45	static $default_settings = array(
46	'hide_after_success' => 0,
47	'redirect_url' => '',
48	'required_fields' =>'',
49	'email_fields' => '',
50	);
51
52	$post_meta = get_post_meta( $post->ID );
53
54	$settings = array();
55	if( ! empty( $post_meta['_hf_settings'][0] ) ) {
56	$settings = (array) maybe_unserialize( $post_meta['_hf_settings'][0] );
57	}
58	$settings = array_merge( $default_settings, $settings );
59
60	$messages = array();
61	foreach( $post_meta as $meta_key => $meta_values ) {
62	if( strpos( $meta_key, 'hf_message_' ) === 0 ) {
63	$message_key = substr( $meta_key, strlen( 'hf_message_' ) );
64	$messages[$message_key] = (string) $meta_values[0];
65	}
66	}
67	$messages = array_merge( $default_messages, $messages );
68
69	$form = new Form( $post->ID );
70	$form->title = $post->post_title;
71	$form->slug = $post->post_name;
72	$form->markup = $post->post_content;
73	$form->settings = $settings;
74	$form->messages = $messages;
75	return $form;
76	}
77
78	/**
79	* @param $form_id
80	* @param array $args
81	* @return Submission[]
82	*/
83	function hf_get_form_submissions( $form_id, array $args = array() ) {
84	$default_args = array(
85	'offset' => 0,
86	'limit' => 1000,
87	);
88	$args = array_merge( $default_args, $args );
89
90	global $wpdb;
91	$table = $wpdb->prefix .'hf_submissions';
92	$results = $wpdb->get_results( $wpdb->prepare( "SELECT s.* FROM {$table} s WHERE s.form_id = %d ORDER BY s.submitted_at DESC LIMIT {$args['offset']}, {$args['limit']};", $form_id ), OBJECT_K );
93	$submissions = array();
94	foreach( $results as $key => $object ) {
95	$submission = Submission::from_object( $object );
96	$submissions[$key] = $submission;
97	}
98	return $submissions;
99	}
100
101	/**
102	* @param int $submission_id
103	* @return Submission
104	*/
105	function hf_get_form_submission( $submission_id ) {
106	global $wpdb;
107	$table = $wpdb->prefix .'hf_submissions';
108	$object = $wpdb->get_row( $wpdb->prepare( "SELECT s.* FROM {$table} s WHERE s.id = %d;", $submission_id ), OBJECT );
109	$submission = Submission::from_object( $object );
110	return $submission;
111	}
112	/**
113	* @return array
114	*/
115	function hf_get_settings() {
116	static $default_settings = array(
117	'load_stylesheet' => 0,
118	);
119
120	$settings = get_option( 'hf_settings', array() );
121	return array_merge( $default_settings, $settings );
122	}
123
124	function hf_array_get( $array, $key, $default = null ) {
125	if ( is_null( $key ) ) {
126	return $array;
127	}
128
129	if ( isset( $array[$key] ) ) {
130	return $array[$key];
131	}
132
133	foreach (explode( '.', $key ) as $segment) {
134	if ( ! is_array( $array ) \|\| ! array_key_exists( $segment, $array ) ) {
135	return $default;
136	}
137
138	$array = $array[$segment];
139	}
140
141	return $array;
142	}
143
144	/**
145	* @param string $template
146	* @param array $data
147	*
148	* @return string
149	*/
150	function hf_template( $template, $data = array() ) {
151	$template = preg_replace_callback( '/\[([a-zA-Z0-9\-\._]+)\]/', function( $matches ) use ( $data ) {
152	$key = $matches[1];
153	$replacement = hf_array_get( $data, $key, '' );
154	return $replacement;
155	}, $template );
156	return $template;
157	}
158
159