原始碼

= 用途 =
This plugin allows external users who are not blog users to submit articles to our blog, like in many news sites. Users will be presented with a typical screen where they can leave their nickname and contact email address, the contents of the article, topic and even select the categories. 

Articles sent by users via this plugin will be added to the database as any other article, but their status will be marked as "Moderated" and will not appear in the front page until the status is changed to Published. Information about the user who posted the article will be stored in two custom fields: submittedBy and submitterAddress.

= 設定 =
This plugin needs to be enabled before it can be used. Its configuration page can be found under the "Manage groups" subgroup. 

As an extra configuration parameter, this plugin allows to either use the non-visual HTML editor or the built-in WYSIWYG editor. 

The custom page where articles can be submitted, can be reached at: 

http://yoursite.com/index.php?op=submissionForm&blogId=X 

where X is the identifier of your blog. 

Since the address above is too difficult to remember, the plugin has a built-in function that will generate the right address for us. Simply add the following line to the place your templates where you would like to show a link to the form:

<a href="{$submissions->pluginTemplatePage()}">Send us a story!</a>

= 注意事項 =
This plugin uses two templates that define the look of the "send story" page and of the feedback page. These templates can be found under plugins/submissions/templates/. The first one is called submitform.template and the second one is called accepted.template 

These two templates are shared by all blogs that use the plugin (it is not possible to define blog-specific plugin templates) but it is possible to modify them to suit your design or your taste better. However, please make sure not to change any of the field names in the submission form or else the plugin will not be able to find its data.