Notice Board

From Frog Knowledge Base
Jump to: navigation, search

= Introduction

A notice board can be built within Frog that allows you to easily add and remove notices that can be displayed to your users via the dashboard.

A notice board is not a single brick within Frog, it is build using other bricks that Frog provides.

Bricks used to build the Notice Board:


Creating a new Notice Board quickly

Locating the Folder

The easiest way to create a new Notice Board within Frog is to copy an existing board. A standard Frog Express build stores it's Notice Boards in the following folder. (All Files -> 00.Frog Learning Platform -> 06. School Notices).

About the School Notices Folder

SchoolNoticesFolder.jpg

As you can see from the image above. The Frog Server already has several Notice Boards built in. Both the Express and Bespoke builds may already utilise these so it's probably best that we create our own.

To do this, we are simply going to copy one of the existing Notice Board and rename it to something more suitable.

Highlight the Student Notices Folder and click the copy button.

I want to create a Notice Board for the after school Dance Class that takes place after school and place it on their Department page so I am going to name my folder 'Dance Class Notices' but you can call it whatever you like.

Final configuration steps

Now we have out own Notice Board Folder all we need to do is make a few configuration changes so that it is completely independent. Because we copied another folder some of the settings will still relate to the folder we copied and not our new one. Also, if any notices were created in the old Notice Board, they will have been copied across too.

Go into the Folder you created. You will see that there are 2 folders, 'Notice' and 'Set Notice'. Firstly you need to go into both of these folders and remove all pages in there. (Do not remove the folders)

Now that we have removed any notices that we brought across, we can now stat to configure the page that will display them. I the folder you copied and renamed, there will be a Frog Page called 'Student Notice Board'. Rename this page so that it

Build a Notice Board System from scratch

Before we begin building the pages, we will create all the pages and folders that are required for the Notice Board to work. This will help you get an understanding of how everything links together.

As the Notice Board could be viewable by anyone, we need to place the files in a folder that can have the relevant permissions applied to it. If you build this in you home directory, you almost certainly will have problems with permissions later.

On a standard Frog Express build Notice Boards are located in: All Files -> 00.Frog Learning Platform -> 06. School Notices

The path may vary slightly on your server. On older Frog Builds this may not even exist, if this is the case you can create the folder within your VLE folder (Not your home directory).

Now that we have a 'School Notices' folder, all of School Notice Boards will be built within here so firstly

Build Steps

Creating the folder structure

  1. Log into your toolkit and create a folder called “Notice Board”, inside this folder, create two more folders called “00. Construction” and “School Notices”.
  2. Inside the school notices folder, create a new folder called “Notices” This is where your notices will live once created.

Creating the notice template page

The notice template page is used to define how your notices will look when created. All newly created notices will be based on this page. We will be using Frogtags in the page, which will be replaced with text when the page is viewed. Frogtags are special codes that when Frog reads will replace with dynamic information, and are always presented in square brackets [] We will be using the following Frogtags:


Noticeboard1.png

[page_name] - Which will become the title of your notice, for example “Geography Trip Today!”

[page_description] – Which will become the text of your notice, for example “Trip is today at 3.30pm, meet in the carpark”

[page_created_by] – Which will be replaced with the name of the person who created the notice

[page_published_date] - Which will be replaced with the date the notice was created.

From within the toolkit in the “Notice Board” – “00. Construction” folder you created previously, create a new page by clicking “new” – “Page” from the menu. Give the page a name of “Notice Template Page” and ensure that under “Template to use” it is set to use “Blank Template”.

Press ok to create the new file.


The new page should open automatically; if not then double click it to open the page for editing. You can now create the template to fit in with the design of your VLE. Here we will just use some basic Frog bricks to create something simple, but you can customise this however you wish.


Noticeboard2.png
Drop a “Highlight” brick onto the page and double click it to open its properties. Replace the text “Heading” with [page_name]

Change the font size to “4” and press ok – you should have something that looks like below:

Noticeboard3.png


Inside the highlight box drop a “Text and Pictures” brick, then double click to open its properties. In this box, type [page_description] Select the text and change its font size to “2” and press ok.


Underneath this text and pictures brick add a “Blank Space” brick, double click to open its properties and give it a height of 10 pixels. Underneath the blank space, add another text and pictures brick, open it up and type the following text:

Published by [page_created_by] on the [page_published_date] You can alter the colour of the tags by highlighting the text and pressing the “Text colour” button and selecting a colour of your choice. When you have done this, ensure that the text is of size “1” then press ok.

Finally, drop a blank space frog Brick below the text and pictures and give it a size of 5 pixels. This will create a little bit of padding between the notices when viewed on a page.

You should now have something that looks like this:

You can now save and publish this page.


Creating the notice board

This is the page that will show your notices. You will also be able to create new notices from this page and will be able to restrict who can do this. Inside the school notices folder, create a new file called “School notice board” again making sure that it is set to use a blank template.

  1. Add a Heading brick to this page, and change the text to “School Notices”
  2. Add a “IF User Type” brick below this, and leave the settings as default for now
  3. Underneath (not inside) the IF brick, add a “Webfiles” brick, open its properties and change the folder that it is looking at to the “Notices” folder which you created at the start. This folder should be within the “School Notices” folder.
  4. Configure the brick in the following way:
    • Set the default view style to “Pages”
    • Set the sort order to “Date, Descesnding”
    • Tick, Hide Icon, Hide Access Labels and Hide Labels In Thumbnail view
  5. You should have something like below:
Noticeboard5.png


Noticeboard6.png
Press ok to close this box.

Now add a text and pictures brick into the top of the “IF User Type” brick and open it. Type the text “Add Notice” and highlight it then press the link icon.

On the “Create a link” Dialogue box, select the “Actions” button on the left hand pane and choose the “Create New Page” action. Press the setup button to configure this action. Select the “Page Name” and “Page Description” boxes. Note that you can also select the “Page available/expires on” box if you wish to be able to create notices that will only be shown as long as the expiry date has not been reached.

In the “New Page Location” tick the “Within a subfolder called” box and type “Notices” in that box. Then in the “Create copy of page” click the “...” icon and select the “Notice template page” which should be within the “00.construction” folder created previously. Press “OK”, then again to take you back to the main page.

You can now choose who will be able to create a new notice by customising the “IF User Type” Brick to only show the “Add notice” link to people in the groups/login profiles that you specify.

If you make sure that your current user is in a group or login profile defined as allowed by the brick then press the preview page button, you should see that you have an empty notice board with a link to add a new notice. Press that now and you will see that a box appears asking for the title and description of the page. The title is your notice title and description is the text of the notice. Try this now and you should see that after you press ok the notice appears. If not, check that the name of the folder you specified in the link actions section (notices) is exactly the same as the name of the actual folder.




Adding the ability to delete notices

Now that you have a basic notice board system setup we will add the ability to edit or delete a notice once it has been created. Open the “Notice Template Page” which is in the “00. Construction” folder you have previously created.

Underneath the text and pictures brick that contains the “Published by [page_created_by] on the [page_published_date]” text, add a “IF User Type” brick. Change the bricks properties so that the groups or profiles that you would like to be able to edit the notices are allowed, then drop a text and pictures brick into the top of the IF statement. Open the text and pictures brick and add the following text:

EDIT DELETE

Give this text a font size of “2”.

Noticeboard7.png

Now highlight the “EDIT” text and click the link button.


On the “create a link” dialogue box select “Actions” from the left pane.


From the list of actions, select “Set Page Properties” and press the setup button.


Select the “Page Name” and “Page Description” boxes and press ok.


Then press ok again to exit.


Now select the “DELETE” text and press the link button. In the “Create a link” dialogue box select “Actions” and select “Delete Page” then press ok, and ok again to close the text and pictures brick.





Testing the edit and delete functions

Navigate to the “School Notices” folder and open the “School Notice Board” page. Preview this page and press the “Add Notice” link. Enter the details and press ok. You should see that your new notice has the “EDIT” and “DELETE” options. Press “EDIT” to edit the page, and press “DELETE” to delete the notice entirely.


Notes: This was a very basic example of what you can do with the right combination of Frogbricks and settings. You can customise most of what you have seen here, for example you could use images instead of text links for the buttons and you can customise the notice board and the notice template page to look exactly how you want, as long as you include the Frogtags shown on the page somewhere.


TODO

Locate images on a standard build. Zip up the images.

Images: Thumb Tack http://videos.design.office.localnet/user/74/115462.png all files / 00. Frog Learning Platform / 06. School Notices / 00. Construction / Template: Resources /

How do I allow other users to administer the Notices system?

PLEASE NOTE THAN ANY FILE PATHS CONTAINED IN THESE INSTRUCTIONS MAY CHANGE DEPENDING ON INDIVIUAL SCHOOL SETUP.

The School Notices witin Frog work on the premise of Frog pages and IF Statements.

The main School Notice Board page can normally be found here:

all files / 00. Frog Learning Platform / 06. School Notices / School Notices / School Notice Board.

On this page you will see an IF...User Type brick that controls who can add notices. By default this would normally be limited to the Platform Admin user group.

You can add new user groups to this IF Statement to allow more users to see this option or you could add users into the existing groups.

If you wish to create a User Groups you will need to navigate to:

Toolkit > Admin > Users > Groups > New Group.

To add additional User Groups into the IF Statement, double click the brick and use the arrows to move groups from the user list to the list used within the brick.


The New Notice button allows users to create a new page which will be seen as the notice. This will appear in the Notice webfiles component that you can see in the middle of this page.

This is displaying the pages in the following folder:

all files / 00. Frog Learning Platform / 06. School Notices / School Notices / Notice.

This is where your School Notices are held.

The set up for the Notice Board and Notice folder are identical for all other notice boards (Staff/Student/Parent/Governor etc).

The notices themselves are in fact copies of the following page:

all files / 00. Frog Learning Platform / 06. School Notices / 00.Construction / General Notice Template.

If you double click into this page you will see another IF Statement where you can allow users to edit and delete the notices that are posted. This is set up in the same way to the IF Statement discussed earlier.

From this explanation you should be able to see that you can set up other notice boards aimed at particular year groups or user groups should you wish to.

You would simply need to copy the existing notices set up for your own use and change the relevant IF Statements and Webfiles Components.

Related Articles