user-submitted-posts / readme.txt

readme.txt in User Submitted Posts – Enable Users to Submit Posts from the Front End 20260916, at readme.txt

795 lines 34.4 KB

Raw Download Zip

1	=== User Submitted Posts – Enable Users to Submit Posts from the Front End ===
2
3	Plugin Name: User Submitted Posts
4	Plugin URI: https://perishablepress.com/user-submitted-posts/
5	Description: Enables your visitors to submit posts and images from anywhere on your site.
6	Tags: frontend post, submit post, guest post, visitor post, public post
7	Author: Jeff Starr
8	Author URI: https://plugin-planet.com/
9	Donate link: https://monzillamedia.com/donate.html
10	Contributors: specialk
11	Requires at least: 4.7
12	Tested up to: 7.1
13	Stable tag: 20260916
14	Version: 20260916
15	Requires PHP: 5.6.20
16	Text Domain: usp
17	Domain Path: /languages
18	License: GPL v2 or later
19
20	Enable visitors to submit posts and images from the front-end of your site. Many features including anti-spam security, content restriction, and more.
21
22
23
24	== Description ==
25
26	🏆 The #1 Plugin for user-generated content
27
28	User Submitted Posts (USP) provides a front-end form that enables visitors to submit posts and upload images. Just add the following shortcode to any Post, Page, or Widget:
29
30	[user-submitted-posts]
31
32	That's all there is to it! Your site now can accept user generated content. Everything is super easy to customize via Plugin Settings page.
33
34	> 🚀 Enable visitors to submit posts from the front end of your site
35
36
37	### ✨ Form Fields ###
38
39	The submission form may include any/all of the following fields:
40
41	* Name
42	* Email
43	* URL
44	* Post Title
45	* Post Tags
46	* Post Category
47	* Post Content
48	* Custom Field 1
49	* Custom Field 2
50	* Custom Checkbox
51	* Challenge Question
52	* Google reCAPTCHA (v2 or v3 Invisible)
53	* Cloudflare Turnstile (Invisible)
54	* Post Images
55	* Agree to Terms
56
57	> 🚀 The first and best plugin for user-submitted content
58
59
60	### ✨ Core Features ###
61
62	* Simple to set up and display the form anywhere on your site
63	* Display the form on multiple posts and pages, or even site-wide
64	* Redirect users to any URL or stay on current page after submitting posts
65	* Set post status as draft, pending, publish, or publish after x number of posts
66	* Option to receive email notifications for submitted posts
67	* Customize email notifications with various post data
68	* Include email links to edit and delete posts
69	* Display a basic login/register/password form
70
71	> 🚀 Enable your visitors to share their own posts and images
72
73
74	### ✨ Form Features ###
75
76	* Display form anywhere via shortcode or template tag
77	* Display only the fields that you want on the form
78	* Set each displayed form field to be required or optional
79	* Automatic client-side form validation provided by [Parsley](https://parsleyjs.org/)
80	* Stops spam via input validation, your choice of captcha, and hidden field
81	* Choose Google reCAPTCHA, Cloudflare Turnstile, or Challenge Question
82	* Choose Google reCAPTCHA v2 ("I am not a bot") or v3 (Invisible)
83	* Optionally require users to be logged in to use the form
84
85	> 🚀 Dial in the perfect form for your visitors
86
87
88	### ✨ More Features ###
89
90	* Lightweight, fast, and secure
91	* Translated into 20+ languages
92	* Option to submit posts as WP Posts or Pages
93	* Provides option to enable a custom form and styles
94	* Customize success, error, and file upload messages
95	* Includes shortcode to display a list of submitted posts
96	* Includes shortcodes to control access and restrict content
97	* Includes template tags to display submitted post content
98
99	> 🚀 Simple to use, lightweight, and flexible
100
101
102	### ✨ Image Uploads ###
103
104	* Enable visitors to upload any number of images
105	* Specify minimum and maximum number of allowed images
106	* Specify minimum and maximum width and height for images
107	* Automatically set submitted images as Featured Images
108	* Automatically display submitted images on the front end
109	* Includes template tags to display submitted images
110	* Includes shortcodes to display submitted images
111	* Form displays thumbnail previews of images
112
113	> 🚀 The easiest way to enable user content
114
115
116	### ✨ Pro Version ###
117
118	Pro version includes many powerful features, with unlimited custom forms, unlimited form fields, multimedia file uploads, and much more. Pro features include:
119
120	* Unlimited forms
121	* Unlimited form fields
122	* Unlimited file uploads
123	* All field types, including textarea, checkboxes, radio, select, file(s), plus input types like text, password, url, search, email, month, time, color, date, range, number, and more
124	* Build post-submission forms, user-registration forms, and contact forms
125	* Build COMBO forms (e.g., forms that submit posts AND register users)
126	* Supports unlimited Custom Post Types
127	* Supports custom Taxonomy fields
128	* Supports Custom Post Status
129	* Supports Post Formats
130	* Custom error messages
131	* Custom redirects
132	* Advanced security features
133	* Advanced shortcode to display submitted posts on the front end
134	* Plus everything the free version can do and more!
135
136	> 🚀 Visit Plugin Planet to [learn more and get USP Pro »](https://plugin-planet.com/usp-pro/)
137
138
139	### ✨ Translations ###
140
141	User Submitted Posts supports translation into any language. Current translations include the following languages:
142
143	Arabic - usp-ar
144	Bengali - usp-bn_BD
145	Chinese (Simplified) - usp-zh_CN
146	Chinese (Traditional) - usp-zh_TW
147	Czech - usp-cs_CZ
148	Dutch - usp-nl_NL
149	French (France) - usp-fr_FR
150	German - usp-de_DE
151	Greek - usp-el
152	Hebrew - usp-he_IL
153	Hindi - usp-hi_IN
154	Irish - usp-ga
155	Italian - usp-it_IT
156	Japanese - usp-ja
157	Korean - usp-ko_KR
158	Norwegian - usp-no
159	Panjabi - usp-pa_IN
160	Persian - usp-fa_IR
161	Polish - usp-pl_PL
162	Portuguese (Brazil) - usp-pt_BR
163	Portuguese (Portugal) - usp-pt_PT
164	Romanian - usp-ro_RO
165	Russian - usp-ru_RU
166	Serbian - usp-sr_RS
167	Slovenian - usp-sl_SI
168	Spanish (Spain) - usp-es_ES
169	Swedish - usp-sv_SE
170	Turkish - usp-tr_TR
171	Urdu - usp-ur
172
173	__Note:__ Most of the default translations are made via Google Translate. So they are automated and may be a little rough. Feel free to make your own translation as desired. Need a translation into your language? [Let me know!](https://plugin-planet.com/support/#contact)
174
175
176	### ✨ Privacy ###
177
178	__User Data:__ This plugin enables users to submit post content. It collects data _only_ from users who voluntarily submit content via the USP form. The only involuntary data that is collected is the IP address of the person submitting the form. The plugin provides an option to disable IP collection completely.
179
180	__Cookies:__ This plugin uses simple cookies to enable dynamic form functionality. No cookies are used for any other purpose.
181
182	__Services:__ This plugin provides an option to enable Google reCaptcha, which is provided by Google as a third-party service. For details on privacy and more, please refer to official documentation for [Google reCaptcha](https://developers.google.com/recaptcha/). This plugin also provides an option to enable Cloudflare Turnstile, which is provided by Cloudflare as a third-party service. For details on privacy and more, please refer to official documentation for [Cloudflare Turnstile](https://www.cloudflare.com/application-services/products/turnstile/). No other outside services or locations are accessed/used by this plugin.
183
184
185	### ✨ Developer ###
186
187	User Submitted Posts is developed and maintained by [Jeff Starr](https://x.com/perishable), 15-year [WordPress developer](https://plugin-planet.com/) and [book author](https://books.perishablepress.com/).
188
189
190
191	== Installation ==
192
193	### How to install the plugin ###
194
195	1. Upload the plugin to your blog and activate
196	2. Configure your options via the plugin settings
197	3. Display the form via shortcode or template tag
198
199	[More info on installing WP plugins](https://wordpress.org/documentation/article/manage-plugins/#installing-plugins-1)
200
201
202	### Display the form ###
203
204	To display the form on any WP Post, Page, or widget, add the shortcode:
205
206	[user-submitted-posts]
207
208	Or, to display the form anywhere in your theme, add the template tag:
209
210	<?php if (function_exists('user_submitted_posts')) user_submitted_posts(); ?>
211
212	__Important:__ When copy/pasting the shortcode, __use the plain-text editor__ or block. Using the Visual/RTE Editor may introduce unwanted artifacts when copy/pasting from a web page. Specifically, if you copy the above shortcode and paste it directly into a visual editor or block, the shortcode may be wrapped in code tags. And when the shortcode is wrapped in code tags, the form will display very poorly on the front end.
213
214
215	### Customize the form ###
216
217	There are three main ways to customize the form:
218
219	* Visit the plugin settings to show/hide fields, configure options, etc.
220	* Enable the custom form template (check out "Custom Submission Form" below)
221	* Developers can use [action and filter hooks](https://developer.wordpress.org/apis/hooks/)
222
223
224	### Custom Submission Form ###
225
226	Out of the box, User Submitted Posts provides a highly configurable submission form. Visit the plugin settings to control which fields are displayed, configure options, and so forth.
227
228	There are cases however, where advanced form configuration may be required. In order to allow for this, USP makes it possible to create a custom submission form. Here are the steps:
229
230	First, copy these two plugin files:
231
232	/user-submitted-posts/resources/usp.css
233	/user-submitted-posts/views/submission-form.php
234
235	Then, paste those two files into a directory named `/usp/` in your theme:
236
237	/wp-content/themes/your-theme/usp/usp.css
238	/wp-content/themes/your-theme/usp/submission-form.php
239
240	Lastly, visit the plugin settings and set the "Form style" option to "Custom Form + CSS".
241
242	You can now customize the two files as desired. The files will not be overwritten when the plugin is updated. For help with making basic changes to the custom form, check out the [USP FAQs](https://perishablepress.com/faqs-user-submitted-posts/#customize-form) at Perishable Press.
243
244	Alternately, you can set the option "Form style" to "HTML5 Form + Disable CSS" to use the default USP form along with your own CSS. FYI: here is a list of [USP CSS selectors](https://m0n.co/e).
245
246	Or, to go further with unlimited custom forms, [check out USP Pro](https://plugin-planet.com/usp-pro/). USP Pro provides a form builder within the WP Admin Area, where you can add any fields, labels, text, and so forth.
247
248
249	### Display submitted posts ###
250
251	User-submitted posts are handled by WordPress as regular WP Posts. So they are displayed along with your other posts according to your theme design.
252
253
254	### Display custom fields ###
255
256	To display submitted custom fields, visit the plugin settings and configure the "Auto-Display" options.
257
258	Also, here is a [Helper Plugin to display Custom Fields](https://plugin-planet.com/usp-pro-custom-field-helper-plugin/). It is designed for use with the Pro version, but also works great with the free version.
259
260	For more flexibility, you can use a variety of WP Template Tags (e.g., [get_post_meta()](https://developer.wordpress.org/reference/functions/get_post_meta/)) to display custom fields.
261
262
263	### Display submitted images ###
264
265	To display submitted images, visit the plugin settings and configure the "Auto-Display" options.
266
267
268	### Display a Featured Image ###
269
270	To display a Featured Image (aka Post Thumbnail) for each submitted post, visit the plugin settings > Image Uploads > Featured Image.
271
272
273	### Shortcodes ###
274
275	User Submitted Posts provides a set of useful shortcodes. Check out the "Display the Form" panel in the plugin settings for examples and quick information.
276
277	[user-submitted-posts] : displays the form on any Post or Page
278	[usp-login-form] : displays a login/register/password form
279	[usp_display_posts] : displays list of all submitted posts
280	[usp_gallery] : displays a gallery of all submitted images for the current post
281	[usp-reset-button url="https://example.com/"] : displays a button to reset the form
282	[usp_access cap="read" deny=""][/usp_access] : limits access to specific user capability
283	[usp_visitor deny=""][/usp_visitor] : limits access to visitors (not logged in) only
284	[usp_member deny=""][/usp_member] : limits access to logged-in users
285
286
287	Here is more information about these shortcodes:
288
289	__`[user-submitted-posts]`__
290
291	Displays the post-submit form. This shortcode does not accept any attributes.
292
293
294	__`[usp-login-form]`__
295
296	Displays the login/register/password form. This shortcode does not accept any attributes.
297
298	To add Google reCaptcha to the form, you can use a free reCaptcha plugin, for example:
299
300	* [reCaptcha by BestWebSoft](https://wordpress.org/plugins/google-captcha/)
301	* [Advanced Google reCAPTCHA](https://wordpress.org/plugins/advanced-google-recaptcha/)
302
303
304	__`[usp_display_posts]`__
305
306	Displays a list of all submitted posts. This shortcode accepts two optional attributes, "userid" and "numposts". Examples:
307
308	[usp_display_posts] : default displays all submitted posts by all authors
309	[usp_display_posts userid="current"] : displays all submitted posts by current logged-in user
310	[usp_display_posts userid="1"] : displays all submitted posts by registered user with ID = 1
311	[usp_display_posts userid="Pat Smith"] : displays all submitted posts by author name "Pat Smith"
312	[usp_display_posts userid="all"] : displays all submitted posts by all users/authors
313	[usp_display_posts userid="all" numposts="5"] : limit to 5 posts from all users
314	[usp_display_posts post_type="page"] : display only submitted pages
315
316	The shortcode attributes can be used to customize the post list as desired. Note that the Pro version of USP provides many more options for the [display-posts shortcode](https://plugin-planet.com/usp-pro-display-list-submitted-posts/).
317
318
319	__`[usp_gallery]`__
320
321	__Note:__ This shortcode works only when added to a submitted post. It does nothing when added anywhere else.
322
323	Displays a gallery of all submitted images for the current post. Customize via the following attributes:
324
325	size = image size as thumbnail, medium, large or full -> default = thumbnail
326	format = whether to make the image a linked image -> default = image (can use image or image_link)
327	target = whether to open linked image in new tab -> default = blank (can use blank or self)
328	class = optional custom class name(s) -> default = none
329	number = the number of images to display for each post -> default = 100
330	post_id = an optional post ID to use -> default = false (uses global/current post)
331
332	Check out the source code inline notes for more info
333
334
335	__`[usp-reset-button]`__
336
337	Displays a button to reset the form. Accepts the following attributes:
338
339	class = classes for the parent element (optional, default: none)
340	value = link text (optional, default: "Reset form")
341	url = the URL where your form is displayed (required, default: none)
342	custom = any attributes or custom code for the link element (optional, default: none)
343
344	Note that the `url` attribute accepts `%%current%%` for the current URL (useful when the form is displayed in the sidebar).
345
346
347	__`[usp_access]`__
348
349	Limits access to specific user capability. Example:
350
351	[usp_access cap="read"]
352	Content for users that have "read" access
353	[/usp_access]
354
355	The `cap` attribute specifies the required capability or capabilities (comma-separated). This shortcode also accepts an optional `deny` attribute. The `deny` attribute displays a message to users who are denied access. Tip: to include markup in the deny message, you can use `{tag}` to display `<tag>`. Check out the "Display the Form" panel in the plugin settings for examples and more info.
356
357
358	__`[usp_visitor]`__
359
360	Limits access to visitors (not logged in) only. Example:
361
362	[usp_visitor]
363	Content for for users who are not logged in
364	[/usp_visitor]
365
366	This shortcode accepts an optional `deny` attribute. The `deny` attribute displays a message to users who are denied access. Tip: to include markup in the deny message, you can use `{tag}` to display `<tag>`. Check out the "Display the Form" panel in the plugin settings for examples and more info.
367
368
369	__`[usp_member]`__
370
371	Limits access to logged-in users. Example:
372
373	[usp_member]
374	Content for for users who are logged in
375	[/usp_member]
376
377	This shortcode accepts an optional `deny` attribute. The `deny` attribute displays a message to users who are denied access. Tip: to include markup in the deny message, you can use `{tag}` to display `<tag>`. Check out the "Display the Form" panel in the plugin settings for examples and more info.
378
379
380	### Template tags ###
381
382	User Submitted Posts provides a set of useful template tags:
383
384	/*
385	Display the Post-Submission Form
386	Usage: <?php if (function_exists('user_submitted_posts')) user_submitted_posts(); ?>
387	*/
388
389	user_submitted_posts()
390
391
392	/*
393	Display the Login/Register/Password Form
394	Usage: <?php if (function_exists('usp_login_form')) usp_login_form(); ?>
395	*/
396
397	usp_login_form()
398
399
400	/*
401	Display a configurable list of submitted posts
402	Usage: <?php if (function_exists('usp_display_posts')) echo usp_display_posts(array('userid' => 'all', 'numposts' => -1)); ?>
403	*/
404
405	usp_display_posts()
406
407
408	/*
409	Check if post is a submitted post
410	Returns true or false
411	Usage: <?php if (usp_is_public_submission()) return true; ?>
412	*/
413
414	usp_is_public_submission()
415
416
417	/*
418	Get all image URLs
419	Returns an array of image URLs that are attached to the current submitted post
420	Usage: <?php $images = usp_get_post_images(); foreach ($images as $image) echo $image; ?>
421	*/
422
423	usp_get_post_images()
424
425
426	/*
427	Display all images
428	Outputs a set of <img> tags for images attached to the current submitted post
429	Usage: <?php usp_post_attachments($size, $beforeUrl, $afterUrl, $numberImages, $postId); ?>
430	Parameters:
431	$size = image size: thumbnail, medium, large or full -> default = full
432	$beforeUrl = text/markup displayed before each image URL -> default = <img src="
433	$afterUrl = text/markup displayed after each image URL -> default = " />
434	$numberImages = number of images to display for each post -> default = false (display all)
435	$postId = an optional post ID to use -> default = uses global post
436	*/
437
438	usp_post_attachments()
439
440
441	/*
442	Display submitted author name and URL
443	This tag displays one of the following:
444	- The author's submitted name as a link (if both 'User Name' and 'User URL' fields are included in the form)
445	- The author's submitted name as plain text (if 'User Name' is included in the form, but 'User URL' is not included)
446	- The author's registered username as a link to the author's post archive (if 'User Name' is not included in the form)
447
448	Usage: <?php usp_author_link(); ?>
449	*/
450
451	usp_author_link()
452
453
454	/*
455	Get an array of image URLs, wrapped in optional HTML
456	Syntax: <?php if (function_exists('usp_get_images')) $images = usp_get_images($size, $format, $target, $class, $number, $post_id); ?>
457	Usage: <?php if (function_exists('usp_get_images')) $images = usp_get_images(); foreach ($images as $image) echo $image; ?>
458	Parameters:
459	$size = image size as thumbnail, medium, large or full -> default = thumbnail
460	$format = whether to make the image a linked image -> default = image (can use image or image_link)
461	$target = whether to open linked image in new tab -> default = blank (can use blank or self)
462	$class = optional custom class name(s) -> default = none
463	$number = the number of images to display for each post -> default = 100
464	$post_id = an optional post ID to use -> default = false (uses global/current post)
465
466	Check out the source code inline notes for more info
467	*/
468
469	usp_get_images()
470
471	These template tags should work out of the box when included in your theme template file(s). Keep in mind that for some of the tags to work, there must be some existing submitted posts and/or images available.
472
473	The source code for these tags is located in `/library/template-tags.php` and `shortcode-login.php`.
474
475
476	### Content Restriction ###
477
478	USP provides three "Access Control" shortcodes to control access and restrict content. Here are some examples to give you an idea of how it works.
479
480	Display form and/or content only to users with a specific capability:
481
482	[usp_access cap="read" deny="Message for users without read capability"]
483	[user-submitted-posts] // Put the USP form or any other content here.
484	[/usp_access]
485
486	Display form and/or any content to logged-in users:
487
488	[usp_member deny="Message for users who are not logged in"]
489	[user-submitted-posts] // Put the USP form or any other content here.
490	[/usp_member]
491
492	Display form and/or any content to visitors only:
493
494	[usp_visitor deny="Message for users who are logged in"]
495	[user-submitted-posts] // Put the USP form or any other content here.
496	[/usp_visitor]
497
498	You can add and use Access Control shortcodes on any WP Post or Page. Tip: you can find this information (and more) in the plugin settings > Display the Form > Access Control.
499
500
501	### Upgrades ###
502
503	Visit the WordPress Plugins screen, locate the plugin, and click "Update" :)
504
505
506	### Restore Default Options ###
507
508	To restore default plugin options, either uninstall/reinstall the plugin, or visit the plugin settings > Restore Default Options.
509
510
511	### Uninstalling ###
512
513	This plugin cleans up after itself. All plugin settings will be removed from the WordPress database when the plugin is deleted via the WP Plugins screen.
514
515	__Note:__ This plugin never deletes any posts. When the plugin is uninstalled/deleted or options reset to default, only the plugin settings are removed. All submitted posts and related meta data must be removed manually.
516
517
518	### Pro Version ###
519
520	USP Pro includes many more awesome features and settings, with unlimited custom forms, unlimited custom fields, multimedia file uploads, and much more.
521
522	* [Learn more and get USP Pro »](https://plugin-planet.com/usp-pro/)
523	* [Watch the Quick Start video »](https://plugin-planet.com/usp-pro-quick-start/)
524	* [Read what users are saying »](https://plugin-planet.com/testimonials/#usp-pro)
525
526
527	### Like the plugin? ###
528
529	If you like USP, please take a moment to [give a 5-star rating](https://wordpress.org/support/plugin/user-submitted-posts/reviews/?rate=5#new-post). It helps to keep development and support going strong. Thank you!
530
531
532
533	== Upgrade Notice ==
534
535	Visit the WordPress Plugins screen, locate the plugin, and click "Update" :)
536
537
538
539	== Screenshots ==
540
541	1. USP Settings Screen (panels toggled closed)
542	2. USP Plugin Settings, showing default options (panels toggle open/closed)
543	3. USP Form (with all fields enabled)
544	4. USP Form (with just a few fields enabled)
545	5. Example showing how to display the form on a Page (using a shortcode)
546
547	More screenshots and infos available at the [USP Homepage](https://perishablepress.com/user-submitted-posts/)
548
549
550
551	== Frequently Asked Questions ==
552
553	Can you add this feature or that feature?
554
555	Please check the [Pro version of USP](https://plugin-planet.com/usp-pro/), which includes many of the most commonly requested features from users. The free version also may include new features in future updates.
556
557
558	How to set submitted image as the featured image?
559
560	Here are the steps:
561
562	1. Visit USP settings > Options panel > Image Uploads > Featured Image
563	2. Check the box and click "Save Settings" to save your changes
564
565	Note that this setting merely assigns the submitted image as the Featured Image; it's up to your theme's single.php file to include `the_post_thumbnail()` to display the Featured Images. If your theme is not so equipped, [check out this tutorial at WP-Mix](https://wp-mix.com/set-attachment-featured-image/).
566
567
568	How to require login?
569
570	To require login to use the form, visit the plugin settings and enable the option to "Require User Login". That will display the submission form only to logged-in users.
571
572	For more fine-grained control, head on over to the [Installation tab](https://wordpress.org/plugins/user-submitted-posts/#installation) and scroll down to the section on "Content Restriction".
573
574
575	How do I change the appearance of the submission form?
576
577	The easiest way to customize the form is via the plugin settings. There you can do things like show/hide specific fields, control the number and size of submitted images, customize the Challenge Question, and so forth.
578
579	Also in the plugin settings, you can choose one of the following form configurations:
580
581	* HTML5 Form + Default CSS (Recommended)
582	* HTML5 Form + Disable CSS (Provide your own styles)
583	* Custom Form + Custom CSS (Provide your own form template & styles)
584
585	To learn how to set up the Custom Form + Custom CSS, visit "Custom Submission Form" under the [Installation tab](https://wordpress.org/plugins/user-submitted-posts/#installation).
586
587	For advanced customization, developers can use [USP action and filter hooks](https://perishablepress.com/action-filter-hooks-user-submitted-posts/).
588
589	To go further with unlimited custom forms, [check out USP Pro](https://plugin-planet.com/usp-pro/). USP Pro provides a form builder within the WP Admin Area, where you can add any fields, labels, text, and so forth.
590
591
592	Can I include video?
593
594	The free version of USP supports uploads of images only, but some hosted videos may be included in the submitted content by simply including the video URL on its own line. Check out the [Embeds documentation](https://wordpress.org/documentation/article/embeds/) for more info. Note that [USP Pro](https://plugin-planet.com/usp-pro/) enables users to [upload video and other file types](https://plugin-planet.com/usp-pro-allowed-file-types/#file-formats) supported by WordPress.
595
596
597	How do I reset the plugin settings?
598
599	To reset plugin settings to factory defaults:
600
601	1. Visit "Restore Default Options" in the plugin settings
602	2. Check the box and save your changes
603	3. Deactivate the plugin and then reactivate it
604	4. Plugin settings now are restored to defaults
605
606	Restoring default settings does not delete any submitted posts. Even if you completely remove the plugin, the submitted posts will not be deleted. You have to remove them manually, if desired.
607
608
609	Can you explain the setting "Registered Username"?
610
611	When "Registered Username" is enabled:
612
613	* If the user is logged in, their registered username is used as the Post Author
614	* If the user is logged out, the setting "Assigned Author" is used as the Post Author
615
616	When "Registered Username" is disabled:
617
618	* The setting "Assigned Author" always is used as the Post Author for all users (whether logged in or not)
619
620
621	How can I translate this plugin?
622
623	Currently the easiest and most flexible method is to [use GlotPress to translate USP](https://translate.wordpress.org/projects/wp-plugins/user-submitted-posts). That is the recommended translation route going forward, but for the time being you may also translate using a plugin such as [Loco Translate](https://wordpress.org/plugins/loco-translate/). FYI, USP's translation files are located in the `/languages/` directory.
624
625
626	Why am I not receiving the Email Alerts?
627
628	Normally the plugin sends an Email Alert each time a post is submitted. If that is not happening in your case, you will need to troubleshoot your setup. Here is a guide on [Troubleshooting Email](https://perishablepress.com/email-troubleshooting-guide/) that should help.
629
630
631	How to disable fancy category/tag select script?
632
633	USP uses the Chosen.js library to enhance the behavior and appearance of the Category and Tag fields. The enhanced fields will be displayed when either/both of the following are true:
634
635	* The option "Multiple Categories" is enabled (for Category field)
636	* The option "Use Existing Tags" is enabled (for Tag field)
637
638	If you want to disable the fancy Chosen script for these fields, you can do so by adding the following code snippet to your WordPress site:
639
640	`<script>var usp_disable_chosen = true;</script>`
641
642	Save changes and done. Also just FYI, here is a guide that explains [how to add custom code to WordPress](https://digwp.com/2022/02/custom-code-wordpress/).
643
644
645	How to change the language for Google reCaptcha?
646
647	By default, the Google reCaptcha field is displayed in English. To change that to some other language, first locate the two-digit abbreviation for your language [here](https://developers.google.com/recaptcha/docs/language). Then add the following code to your theme (or child theme) functions.php, or add via [custom plugin](https://digwp.com/2022/02/custom-code-wordpress/):
648
649	`function usp_recaptcha_querystring($query) { return 'en'; }
650	add_filter('usp_recaptcha_querystring', 'usp_recaptcha_querystring');`
651
652	Notice where it says `en`, that is the two-character language code you want to replace with your own. Then save changes and done.
653
654
655	Where can I check out a demo of the USP form?
656
657	There is a simplified [USP Demo](https://perishablepress.com/wp/wp-content/online/pages/user-submitted-posts-demo.html) at Perishable Press. Note the demo form is non-functional, just there to give you a general idea. The actual form provided by the plugin has more features, functionality, etc.
658
659
660	How to allow blank targets in post content?
661
662	By default, USP removes any `target="_blank"` attributes in submitted post content. This is a recommended security feature. It is possible however to allow blank targets:
663
664	`function usp_content_patterns($array) { return array(); }
665	add_filter('usp_content_patterns', 'usp_content_patterns');`
666
667	That code can be added via theme (or child theme) functions.php, or add via [custom plugin](https://digwp.com/2022/02/custom-code-wordpress/).
668
669
670	How to disable all HTML tags in submitted posts?
671
672	Add the code snippet provided [here](https://perishablepress.com/faqs-user-submitted-posts/#allowed-tags).
673
674
675	mod_security is preventing saving changes?
676
677	If mod_security is installed on your server, it may prevent saving changes in the plugin settings. For a further explanation and quick copy/paste code solution, check out [this forum post](https://wordpress.org/support/topic/good-but-cannot-safe-any-changes/#post-18754005). Thanks to [tomlandon](https://wordpress.org/support/users/tomlandon/) for sharing the code solution.
678
679
680	How do the edit-post and delete-post links work?
681
682	When `%%edit_link%%` is included in the Email Alert settings, a link will be included in the email alert that takes capable users to the Edit Post screen for the submitted post. Likewise when `%%delete_link%%` is included in the Email Alert settings, a link will be included that enables capable users to delete the submitted post. Note that these links work only for users who have sufficient capabilities (e.g., Editor, Admin) AND are logged into WordPress when the link is clicked. For more details and tips, check out the [USP FAQs](https://perishablepress.com/faqs-user-submitted-posts/#delete-post-message) at Perishable Press.
683
684
685	Action and filter hooks
686
687	Here are some of the most commonly used [action and filter hooks](https://developer.wordpress.org/apis/hooks/) provided by User Submitted Posts:
688
689	Filters:
690	usp_post_status
691	usp_post_author
692	usp_form_shortcode
693	usp_mail_subject
694	usp_mail_message
695	usp_new_post
696	usp_input_validate
697	usp_require_login
698	usp_default_title
699
700	Actions:
701	usp_submit_success
702	usp_submit_error
703	usp_insert_before
704	usp_insert_after
705	usp_files_before
706	usp_files_after
707
708	For more, check out the [list of action hooks for User Submitted Posts](https://perishablepress.com/action-filter-hooks-user-submitted-posts/). And of course, check the source code for even more. If you need a hook that is not available, let me know via the contact form below.
709
710
711	Custom Fields attached to submitted posts
712
713	Each submitted post attaches a variety of custom fields, including:
714
715	* `is_submission` - indicates that the post is a user-submitted post
716	* `user_submit_image` - the URL of the submitted image (one custom field per image)
717	* `user_submit_ip` - the IP address of the submitted-post author
718	* `user_submit_name` - the name of the submitted-post author
719	* `user_submit_url` - the submitted URL
720	* `usp_custom_field` - configurable Custom Field
721
722	For a more complete list, submit a test post and visit the "Edit Post" screen. There you can toggle open the "Custom Fields" meta panel and view all attached custom fields.
723
724
725	More FAQs
726
727	Want to read some more FAQs? Check out the [USP FAQs at Perishable Press](https://perishablepress.com/faqs-user-submitted-posts/)
728
729
730	Questions? Feedback?
731
732	Send any questions or feedback via my [contact form](https://plugin-planet.com/support/#contact). Thanks! :)
733
734
735
736	== ✨ Support Development ==
737
738	I develop and maintain this free plugin with love for the WordPress community. To show support, you can [make a donation](https://monzillamedia.com/donate.html) or purchase one of my books:
739
740	* [The Tao of WordPress](https://wp-tao.com/)
741	* [Digging into WordPress](https://digwp.com/)
742	* [.htaccess made easy](https://htaccessbook.com/)
743	* [WordPress Themes In Depth](https://wp-tao.com/wordpress-themes-book/)
744	* [Wizard's SQL Recipes for WordPress](https://books.perishablepress.com/downloads/wizards-collection-sql-recipes-wordpress/)
745
746	And/or purchase one of my premium WordPress plugins:
747
748	* [BBQ Pro](https://plugin-planet.com/bbq-pro/) - Blazing fast WordPress firewall
749	* [Blackhole Pro](https://plugin-planet.com/blackhole-pro/) - Automatically block bad bots
750	* [Banhammer Pro](https://plugin-planet.com/banhammer-pro/) - Monitor traffic and ban the bad guys
751	* [GA Google Analytics Pro](https://plugin-planet.com/ga-google-analytics-pro/) - Connect WordPress to Google Analytics
752	* [Head Meta Pro](https://plugin-planet.com/head-meta-pro/) - Ultimate Meta Tags for WordPress
753	* [REST Pro Tools](https://plugin-planet.com/rest-pro-tools/) - Awesome tools for managing the WP REST API
754	* [Simple Ajax Chat Pro](https://plugin-planet.com/simple-ajax-chat-pro/) - Unlimited chat rooms
755	* [USP Pro](https://plugin-planet.com/usp-pro/) - Unlimited front-end forms
756
757	Links, tweets and likes also appreciated. Thanks! :)
758
759
760
761	== Changelog ==
762
763	Thank you to everyone who shares feedback for User Submitted Posts!
764
765	If you like USP, please take a moment to [give a 5-star rating](https://wordpress.org/support/plugin/user-submitted-posts/reviews/?rate=5#new-post). It helps to keep development and support going strong. Thank you!
766
767	> 🚀 Unlock powerful features and build unlimited forms with [USP Pro »](https://plugin-planet.com/usp-pro/)
768
769
770	20260916
771
772	* Improves sanitization of meta box output
773	* Tests on WordPress 7.1
774
775	20260810
776
777	* Updates plugin settings page
778	* Tests on WordPress 7.1
779
780	20260608
781
782	* Improves security of display shortcodes
783	* Tests on WordPress 7.0
784
785	20260422
786
787	* Fixes bug with reset options
788	* Adds allowed tags to sanitize checkbox output
789	* Updates plugin settings page
790	* Improves readme.txt documentation
791	* Tests on WordPress 7.0
792
793
794	Full changelog @ [https://plugin-planet.com/wp/changelog/user-submitted-posts.txt](https://plugin-planet.com/wp/changelog/user-submitted-posts.txt)
795