Latest releases
Latest stable release: 4.0.4
View changelog »
Copyright © 2005-2007 Spoonlabs d.o.o.
All rights Reserved.
This plug-in will add an important social component to your website - user generated content. It will allow members to easily contribute to the website by submitting their own news and articles. You can allow them not only to read articles you publish, but also to become an important figure for your website by taking part in its creation.
The plug-in allows maximum control over preferences and submitted stories - you can allow or restrict almost everything.
You need to access the Plug-ins section. Click on the Plug-ins link which is located in Main menu at the top of your administrator panel.
You should have all the installed plug-ins listed on your left-hand side.
A list of all plug-ins currently registered to the system is displayed on the right hand side of the screen.
To install Submit story plug-in you need to click on the install icon on the right side of the plug-ins name.
This will take you to the page with the installation link: Click here to Install the plug-in
After you run the installation, you will be informed that the plug-in was successfully installed.
You may easily go back to the Plug-ins page, by following the link: Click here to go to Plug-in
To place a link to a frontend for access to Submit story page, you need to insert the following code in your template:
If you use friendly URL option:
<vte:if test="{CURRENT_USER}">
<a href="{VIVVO_URL}app/submit_story/">Submit story</a>
</vte:if>
If you do not use friendly URLs:
<vte:if test="{CURRENT_USER}">
<a href="{VIVVO_URL}index.php?plugin=submit_story">Submit story</a>
</vte:if>
We recommend you to place the previous code in your footer.tpl file which is located in VIVVO_ROOT/templates/CURRENT_TEMPLATE/box/ just below this code:
<vte:if test="{CURRENT_USER.is_admin}">
<a href="{VIVVO_URL}admin/index.php"><vte:value select="{LNG_SITE_ADMINISTRATION}" /></a>
</vte:if>
If you get the blank page when accessing www.example.com/index.php?plugin=submit_story or www.example.co/app/submit_story, you should copy submit_story.tpl file from the VIVVO_ROOT/plugins/submit_story/templates to VIVVO_ROOT/templates/xhtml/plugins. This issue is related with PHP mkdir function that depends on Apache user privileges so the file cannot be copied automatically during installation.
To uninstall Submit story plug-in you need to click on the uninstall icon on the right side of the plug-in name.
This will take you to the page with the link for uninstall: Click here to uninstall the plug-in
You will be informed that the plug-in was successfully uninstalled and you may return to the Plug-ins page by clicking the link: Click here to return to Plug-in home page.
The path to the Submit story plug-in:
Click on the Plug-ins link (which is located in Main menu at the top of your administrator panel).
Choose Submit story plug-in from the list of all installed plug-ins (on the left side of the screen).
The preferences can be accessed only by users with administrator-level privileges. Members may submit stories from the front end.
Default status - Choose if the submitted stories will be automatically active or they require moderation. In that case their status will be set to pending until administrator approves it.
Category - You can choose between two options: you may allow your members to submit articles to a pre-defined category or you may allow them to publish to a category of their choice.
Allow uploads - Decide if you want to allow members to upload abstract images.
Allow HTML (WYSIWYG) - If you choose 'Yes', members will have the advanced options for content formatting. If 'No' is chosen, they will be allowed to submit only default formatted text.
Show comments - Select if you will allow comments to be posted on the stories.
Show ratings (rate the article) - Select if you will allow visitors to vote for the stories.
Publish to feed - RSS (which stands for Really Simple Syndication) is a web technology that allows people to subscribe to receive updates from your website. When you publish a new web page or update an existing one, you may select the page to also appear as an item in various RSS feeds. People using RSS readers or news aggregator software then receive an alert anytime the page content changes. RSS also allows people to easily add links to your content within their own web pages.
Access this plug-ins page any time to change preferences and manage pending stories.
Story management panel will load with a list of all pending stories that members have created on the right hand side of the screen.
From this administrative panel you are able to approve and edit existing stories, or create new articles by clicking on the Add new article link (you will be provided to Article section).
To have some story published as an article on your website you need to approve it by changing its status to Active. Select an article by checking the box next to it and select Active from 'Select action' drop-down menu. Approved story will be moved then to the articles section and you may access it from this point.
To edit a story before approving it click on the edit icon on the right side of the story name.
This will take you to the page where you can change all parameters and content that member has entered during a story creation process.
Follow a link from the frontend to be provided to a page where you will submit your content and have a list of previously added stories. You must be registered and logged-in in order to see the appropriate link and have access to submit a story page.
The following described options and screenshots may differ and some fields may not display depending on administrator preferences.
Title - Enter the title (name) of your story (for example, 'This is my new story'). If you do not enter it you will get a 'Missing argument(s): Title' message.
Abstract - Enter your Abstract (summary) in the text editor. Your text should be short two or three sentences long.
Category - Select a desired category from the drop-down menu where you want your story to show up.
Abstract image - To add an image to your story, click Browse button and in the dialog box select the current location of the image that you want to add.
Image Caption - Image caption field has the same effect like Alt tag in HTML. When you point your cursor on some image on your website, this image description will appear.
Click on the 'Submit' button when you are done. You will get the message 'Story is waiting for approval'.
If allowed, the body content of the story can be managed by WYSIWYG Text Editor. The WYSIWYG (What You See Is What You Get) editor allows you to edit and format text, pictures and other media files.
Full manual on using WUSIWYUG editor can be found HERE.
In this box on the right side of the screen you may see the list with the titles of your pending stories (stories that wait for approval).
This box, which appears below 'My pending stories' box contains links to your published stories. You may click on any title and you will be provided to a live article page where your story is published.