Share a post

This page describes the Share a post page.

The Share a post page shows a custom form to create a new organisation blog post. These blog posts will appear on the organisations public profile page.

Organisation posts are stored as blog posts in the organisation blog (link below).

The Share a post page is based on a Nationbuilder Feedback page. A feedback message is added when a new blog post is created.

Live:

https://www.landcaretas.org.au/share-post

Submission Feedback Page Control Panel:

https://landcaretas.nationbuilder.com/admin/sites/4/pages/21311/activities

Organisation Posts Blog (where new posts are created and should be moderated):

https://landcaretas.nationbuilder.com/admin/sites/4/pages/21310/blog_posts

Submission Feedback Page Tags:

page_create_post - Activates the special form template that makes this feedback form create posts.
blog_slug:org_posts - Specifies the blog in which to create the document posts (/org_posts)
page_org_editors_only - Limits the page access to organisation editors only
page_no_robots - Hides the page from search engines

#Moderation Process

After submitting a new post, a new message will be added to the submission feedback page detailing the new submission. The user will be tagged shared-post-to-group and can be added to a path in NationBuilder (the exact behaviour can be configured in the control panel here: https://landcaretas.nationbuilder.com/admin/sites/4/pages/21311/feedback/edit). Admins can follow this page to be notified when a new submission is made.

Like other moderation systems on the Landcare Tasmania website - if a document blog post page status is "unlisted" it is pending moderation. When it has been moderated and approved - it should have it's page status set to "published".

All new posts are set to "unlisted" and will need to be published by a site admin.

If a document is not "approved" (you don't want it published on the site) - keep it as "unlisted", set to "hidden", or delete the post.

This describes the blog post form fields in detail.

Title/Headline

Textbox

This will be stored in the blog post Headline.

Content

Textarea

The main text content of the post will be stored in the blog post Content field. (note this is the 'content before flip' when editing in Nationbuilder).

Photo

The user can upload a single image with their post. This is stored as a file attachment on the blog post. To view the attachment, click into the blog post and then click the Files tab.

Note that if you see multiple file attachments then this indicates that the user has edited their post and replaced the photo. Attachments filenames are in the format updated-DATETIME-FILENAME.jpg, and only the latest attachment is shown.

author:USER_ID

This tag will be added to all submissions - it will not display anything but is useful for admins if they want to see who submitted the post or to filter to all documents submitted by that user.

org_post:ORG_ID

This tag links the blog post with the organisation that the post was created for. ORG_ID is the profile ID of the organisation the post was created for. It is how the blog posts for that organisation are found when displaying them on the organsation profile page.

Note the org ID is originally passed to the submit page using a URL parameter - the URL is in the format /share-a-document?org_id=ORG_ID).

If the user is the author of the document post or they are an editor of the organisation the post is for, then an "Edit Cog Icon ⚙" appears in the top right corner on the post page.

Clicking the Cog Icon ⚙ will show a drop down menu with two menu items:

Edit Post - clicking this option will show a form where the user can edit their post. The user can update the post title, content, and replace the photo. Note that editing the post will set the status back to "unlisted" and it will need to be moderated again by a Landcare site admin. A new feedback message will be added with a note that this post has been edited.
Delete Post - clicking this option will set the post to "hidden". Posts are set to hidden rather than deleted for safety - deleting a post in Nationbuilder is destructive and unrecoverable. Hidden posts should be periodically cleaned up and fully deleted by Landcare Admins.