WP_Submission
WP_SubmissionShow appreciation for WP_Submission
- Rate it on WordPress.org
- Tell you friends.
- Help support its development
WP_Submission is a free WordPress plug-in that allows you to do round ups, user submitted link posts or blog carnivals. Original idea by ChrisG.com . WP_PostNotes is integrated to allow submission details to be kept with each submission but not be visible in the post.
Sample Screen
- download WP_Submission.
- Copy to your ‘wp-content/plugins‘ directory.
- Log in with an administration account.
- Select the ‘Plugins‘ tab.
- Scroll down to ‘WP_Submission’ and click ‘activate‘.
Upgrading
With the release of WordPress =.5, WordPress now supports BBCode style shortcodes. Which means the preferred method of inserting content into is post via a plugin is with [] instead of <!– –>. With this in mind WP_Submission now has support for this method. Once WordPress =.5 is the predominant version, the <!– –>method will be dropped, and the plug-in rewritten to use the internal API calls, hopefully meaning for a more efficient plugin.
To upgrade previous xxsinglexx already in you posts
You can choose to either manually update posts from the list provided or choose to autoupdate.
Usage
To use WP_Submission insert the following BBCode shortcode into your post where you would like the Contact form to appear.
[submission post="post" email="email@address.com" antispam="yes" allowcopy="yes" template="example" once = "yes" timelimit = "31536000" antispam = "no"]
Attributes
- post
- Purpose: The post to create from the submitted data
.
- Purpose: The post to create from the submitted data
- email
- Purpose: A comma separated list of email addresses that the Contact form will be sent to. Each address corresponds to the selected subject. If no subject is supplied the first address in the list will be used.
- Default: The email address of the author of the post/page.
- antispam
- allowcopy
- Purpose: Whether the user will be allowed to select if they wish to receive a copy of the message.
- Default: yes.
- template
- Purpose: This indicates the forms to be used when creating the submission
- once
- Purpose: Allow the survey to be used only once in a given time frame
- Default: Yes
- timelimit
- Purpose: The time period in which a survey cannot be submitted, in seconds.
- Default: “31536000″ seconds ( 365 days )
To create a new template.
- Create a directory inside the ‘pages‘ folder inside the plug-ins directory.
- Name the folder to represent the template that you will use when inserting the survey into your post or page.
Inside the template directory you can create a number of files to modify the look of the form.
- form.html
- Purpose: this is the most important file of the all. This is the HTML form that will be used for the form. The only requirements for this file is that you omit the <form> tag and submit button as these will supplied by the plug-in.
- alreadydonemessage.html
- Purpose: This the message that will be displayed to the user if they have already filled in the form. This is optional, if it is not supplied a default one is used
- thanksmessage.html
- Purpose: This is the message that will be displayed when the form is submitted. This is optional, if it is not supplied a default one will be used.
- closedmessage.html
- Purpose: This is the message that will be display if this form is closed. This is optional, if it is not supplied a default one will be used.
- rssfeedmessage.html
- Purpose: There are problems filling out forms in RSS feeds so the form is disabled in the RSS feed. This is the message that will be displayed when the form is seen from an RSS feed. This is optional, if it is not supplied a default one will be used.
Anti-SPAM
The anti-SPAM is done by asking the user to name the nth colour in a random selection of coloured boxes. This does not require your site to have any graphics modules loaded.
Default Submission Form Fields
A user wishing to use the submission form will be asked to fill in the following fields
- Your Name
- Purpose: The name of the user, this is a required field.
- Default: The registered user name, if the user if logged in.
- Your Email Address
- Purpose: The email address of the user, this is a required field.
- Default: The registered user email address, if the user if logged in.
- Your Website
- Purpose: The users site.
- Default: The registered user site, if the user if logged in.
- Link Url
- Purpose: The URL of the link being submitted.
- Link Caption
- Purpose: The caption of the link being submitted.
- Description
- Purpose: A description for the submitted link
- Human Response Check
- Purspose: To stop abuse of the Contact form. This field is required if the antispam option is enabled on for the form.
- receive copy?
- Purpose: Allows the user to select if they wish to receive a copy of their message. This is only asked if the option is enabled for the form.
- Default: no.
How it works
When new content is submitted, you will receive a notification email containing what has been submitted and details About the submitter. If the submitter selected to receive a copy they will receive an acknowledgement email containing just there submission..
When you wish to close submission all you need to do is publish the new post.
Postnotes are entered into the submission for you to see the IP and email of the submitter. You can either delete these once you have checked the submission or let the included WP_PostNotes plug-in to keep the notes but not display them to visitors.
Version History
- 0.5.0
- Initial internal release.
- 1.0.0
- Email notifications added.
- 1.5.0
- Initial Public Release.
- 1.6.0
- 1.7.0
- Corrected and incompatibility with WordPress 2.3
- 2.0.0
- Total recode.
- Added style sheets.
- Added the ability for logged in users not to supply email and name.
- 3.0.0
- Total recode, based around the WP_ContactMe Plug-in
- Improved submitter details
- 3.1.0
- added templates
- once attribute
- time-out attribute.
Future Developments
- Provide ability to modify submitted form.
If you liked this plug-in visits our download area where you will find many more.
If you have questions, have found any bugs, or you would like to see features added to WP_Submission please feel free to use the form at the bottom of the page to Contact us. If WP_Submission doesn’t fill your needs , feel free to Contact us to discuss a specially commissioned plug-in.
If you liked WP_Submission please:
- Tell you friends.
- Write a review and tell your subscribers.
- Rate WP_Submission on WordPress.org
You can also make a donation to Help support its development.
WP Submissions, sounds like the plug-in I have been looking for.
This is Canada’s thanksgiving so I think my online time is up for the day and face stuffing is about to begin, but I will jump on this tomorrow bright and early to see what it will do for me.
Thanks for the post.
Happy thanksgiving. Maybe one day I’ll be in Canada to celebrate it :).
IF you have any suggestions of improvements feel free to make suggestions.
This is the Plugin i have been looking for ages!, Looks cool, but not exactly what i needed!
I m Modifying the Plugin to Allow Category Selection, Integrated Login (with Wordpress Login), so that users dont have enter Name, email and URL.
Include Post Title.
Rest of the data attaching it as a Custom Field data, so that it becomes easier to use.
MOST OF ALL…. Thanks for this cool Plugin…
excellent plugin…it is perfect for my blog’s request for user submitted fiction. thanks for your hard work!
I can’t make it work. Please type the code that we must put on post to see the form.
I tried the code from your image Code tag and nothing happen.
The code you must type is
<!–submission post=”newpost” –>
be careful when you cut and paste this as as the > and < can be copied wrong when cutting from HTML page.
Also make sure than whenyou paste this into the post, you do it in the HTML window, not the Richtext window.
Do you have an example of this somewhere so I can see it in action?
Thanks
Hello,
I can’t make it work, it seems wordpress replace this by
I type it in the post code area … tried many times…
Someone can help me?
Thx.
Sorry for my random english…
oups the tags doesn’t work… i mean wordpress replace the comment tags…
@Elaine Vigneault: You can find it used at http://www.chrisg.com in don’t think he has an open submission at he moment but he does at least 1 per month . The only way to see it full action is to install it and try it. Most of the features are for admin which you would not be able to see on sites where it is used.
@Nicko: If you me you can’t get the plug-in working, can you please give me some more information. ie: WordPress version , any error messages.
Doesn`t work. I`ve tried many times but nothing.
I`ve saw something when i add this code : <!– submission post = “{newpost}” –> , it transforms it into <!–– submission post = “{newpost}” ––>, and when i open the post i don`t see anything only blank. I`m using Wordpress version 2.2.2 Thanks
@Andrei: Sorry for the confusion it, It would appear that the example text is displaying wrong in WordPress. It appears that WordPress displays two consecutive minus signs as one minus sign. I’ve changed the post so that the example will display correctly.
The syntax of the tag is the same as that of the HTML comment tag.
Great job! When is the next release of WP-Submission coming?
@Bryan: Thanks. There are no plans to release a new version at the moment.
It would be nice if we had the ability to edit the submission fields, create our own, etc. Additionally, does this work with version 2.5 of WordPress? I think some people were having issues.
@Bryan: This is planned for a new version, one a satifactory technique has been devised for creating the forms and also preseting the forms.
. All these plugins are being reviews to check for compatibility with WordPress 2.5
@Bryan: As to the compatibility with WordPress 2.5. Testing has just been done on a fresh install of 2.5 and it worked as expected. If you know of anyone how is having problems can you get to post more details.
When do you anticipate the new version to arrive?
@Bryan: Depeding on worlkload the new plugin should be started on soon.
tried it on my test site. I have wordpress 2.5.1 installed. I installed and activated. Couldn’t find any reference to where submission would go on the back end. So, I tried a submission form. the form showed up, but when I was not logged it, i couldn’t get the human check accepted. no matter what color i tried to describe: black, white, pink, blue, cyan, yellow, it wouldn’t accept my answer. So, I tried logged in and got this error when i submitted: wp-content/plugins/wp-submission/classes/contactform/base.php on line 59
A fix has been release. for the color problem. Not sure what caused the error message. See if you get itin the fixed version.
Same problems if you want to check it on the site. Do you need all other plug-ins disabled?
Call to undefined function get_default_post_to_edit() in /wordpress.callaodesigns.com/wp-content/plugins/wp-submission/classes/contactform/base.php on line 59
If you could, this is a stumper at the moment. That command is post of WordPress and you’re running in on the version it was developed on. I would be hand to rule out conflicts with other plugins.
Ok, I’ve disabled all plugins, upgraded wp-submission to 3.0.1 and it’s the only one active. I just tried a submission not logged in and got this: Fatal error: Call to undefined function get_default_post_to_edit() in /wordpress.callaodesigns.com/wp-content/plugins/wp-submission/classes/contactform/base.php on line 60
Let me know if there’s something else I should do… change theme?
Am I doing something wrong in the way I’m calling the form within the post?
Thanks for your input. I’ve manage to track down the problems. Its not something that is installed on your system, its something that is installed on mine that is already including the file, even though I have a minimal installation for testing.
I’ve sorted the problem and version 3.0.2 solve this.
Thanks for all the feedback
It works now! Thanks.
It is not clear to me how to have the results of the submission included in the post with WP_PostNotes. Is there any way to eliminate the emailing portion of the plugin so that submissions are only stored as post notes. I would love to have my users be able to create these and would like to simplify as much as possible. I will probably write a quicktags button, but only want to have one or two inputs (Title of field and default value?!).
Great work on all of these plugins! If I can make use of them I will be sure to donate.
As I have been working with this plugin further I see that a new post is made that contains the data submitted. Any way to get this data in to the orriginal post so that when the author views the post again all the submissions are there for the authors eyes only?
As a side not I have a plugin idea that I’ve been wanting to do for a while concerning delicious that I’d love to pitch to you. It seems you have a pretty good plugin creation system and with your delicious plugin already have most of the structure there. Please email if you are interested in hearing the idea.
@clark- The only way to keep a copy of the original post would be to copy this into the [postnotes] area before you start editing.
Hello,
Nice plugin. I’d like to request two features that I think would be handy.
For the flags,
[submission post=”post” email=”email@address.com” antispam=”yes” allowcopy=”yes” template=”example” once = “yes” timelimit = “31536000″
I’d like to see two extra flags…
sendmail=”yes” (or no)
Just posts the submission without sending an email
cleanpost=”yes” (or no)
Rather than insert the postnote info and the have the post be in html, I’d rather have JUST the plain text of the post that th evisitor submitted appear in the Wp admin window field. I know I can cut it all out (html, postnote), but it would save alot of time.
Only other feature to make it better is have the ability for the form to insert what the post’s title will be. Another user hinted at adding this function.
Cheers,
Carlos (Toffee)
@Carlos- There are a couple of undocumented advanced features that should allow you to do what you need. They are for future possible features, but should not change when they are implemented.
To stop email you can use the attribute email=”no”.
To design the out put results you can use a template file, results.html.php.
The template file is basically a php file so you will be able to read the $_POST variable and output as you wish.
It will how ever still be placed in <li> tags for each post.
The post notes cannot be turned off but the information inside can be modified by creating a template file info.html.php.
I’m not sure what you mean by inserting the posts title.
this what appears:
Submissions are now closed
help!
this what i put
[submission post="post" email="aiug_alegna@yahoo.com" antispam="yes" allowcopy="yes" template="example" once = "yes" timelimit = "31536000" antispam = "yes"]
@Angel:
All the attributes in the example are not required.
The post attribute indicates the title of the post that is to be created from the submissions.
It would appear that you have a post called post and that it is published. If the post is published this indicates that the submissions are closed.