SMF2.1:Calendar administration: Difference between revisions From Online Manual

Jump to: navigation, search
mNo edit summary
 
m (→‎Add New Holidays: fixed 2 contractions)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{TOCright}}<small>If you're looking for calendar as a regular user, see [[calendar]]</small>
{{WIP}}
{{TOCright}}


{{versions|versions}}
{{versions|versionsmore}}


To enable the calendar and the settings found on this page you must first go to [[Core Features]], select the Calendar button (turning it green) and press save.
The Calendar feature allows administrators to provide, or not provide, a calendar for the forum. Holidays can be managed in great detail, including many other options for customizing the calendar. Once enabled, it allows members to post special events, if the administrator has given them permission. If you are a member trying to use the calendar, you can find instructions on the [https://wiki.simplemachines.org/smf/SMF2.1:Calendar Calendar manual page].
 
To enable the Calendar, check ''Admin Center > Forum > Calendar > Calendar Settings > Enable calendar''. Then click the ''Save'' button in the bottom right corner. After that, more administrative options will appear on that page, and as well, another page, ''Manage Holidays'' will show up. Then you will find the Calendar itself in the main menu, at the top of the forum index page.
 
== Calendar Settings ==
These are all the options and settings which will appear after you have enabled the calendar.
 
*'''Membergroups allowed to view the calendar''' - Check the member groups that you want to be able to view the calendar.
*'''Membergroups allowed to create events''' - Check the member groups that you want to be able to create new events in the calendar.
*'''Membergroups allowed to edit their own events''' - Check the member groups that you want to be able to edit the events they created.
*'''Membergroups allowed to edit any events''' - Check the member groups that you want to be able to edit any events in the calendar.
<hr>
*'''Max days in advance on board index''' - Show how many days in advance to show calendar events on the board index. For example if this is set to 7, the next week's worth of events will be shown.
*'''Show holidays''' - Select from the dropdown menu where you want holidays to be displayed.
*'''Show birthdays''' - Select from the dropdown menu where you want birthdays to be displayed.
*'''Show events''' - Select from the dropdown menu where you want events to be displayed.
*'''Allow events to be exported in iCal format''' - Checking this option exports a text file in the iCal format, that can be imported into other calendar applications.
<hr>
*'''Default board to post events in''' - Events can be posted in any board, but this sets the default board in which you would like events to be posted.
*'''Show days as link to 'Post Event'''' - Clicking this allows users to be able to click a day in the calendar to create a new event (as long as they have the proper permission). Otherwise, they can click the ''Post Event'' button to create a new event.
*'''Allow events not linked to posts''' - Checking this option allows users to create new events which are not also posted in the forum. The option ''Show linked events in topic display'' must be disabled, to prevent the link from showing in the forum message.
*'''Show linked events in topic display''' - Checking this adds a link to the new event, above the message in the forum that announces the event. Otherwise, the event is still announced in the forum, but without a link to the calendar event.
<hr>
*'''Minimum year''' - Select the earliest, or "first" year for your forum's calendar.
*'''Maximum year''' - Select the latest, or "last" year for your forum's calendar.
''Note that the larger span of years that you create, the more holidays you will have to manage on the Manage Holidays page. For example, Mother's Day is on a different date every year. So if you set up ten years worth of calendars, you will have ten Mother's Days to manage.
<hr>
*'''Max number of days an event can span''' - Select the maximum number of days that an event can span. Set to zero for no limit.
<hr>
*'''Disable three Month Blocks''' - Checking this box prevents the three small calendar month blocks from showing on the left.
*'''Show Week links''' - This shows a link at the far left of each week, which displays only that week, if you click on it. Choose from the dropdown menu, in which calendar you want these links to show up. It is a graphic link rather than a text link.
*'''Show ''Previous'' / ''Next'' Month Links''' - This places graphic links to the previous and next month, for easy navigation.
*'''Short Day Titles''' - This shortens the days' titles, for example "Mon" for "Monday".
*'''Short Month Titles''' - This shortens the months' titles, for exampe "Jan" for "January".
<hr>
Be sure to click the '''Save''' button in the bottom right corner when you finish setting your options.


== Manage Holidays ==
== Manage Holidays ==
On the ''Manage Holidays'' page of the [[Calendar]] section of the Administration panel you can edit existing holiday events and add new ones.
On ''Admin Center > Forum > Calendar > Manage Holidays'' page, you can edit existing holidays and add new ones.
 
This is a listing of all of the holidays already added to your forum's Calendar. There are three columns: the Name of the holiday, the Date of the holiday, and a checkbox. With the checkbox and ''Delete Selected'' button you can remove any holidays that you do not want.


First you will see a listing of all of the holiday events already added to your forum's Calendar. Next to that is the date of the event and next to that is a checkbox that you can check and click the ''Delete Selected'' button located at the button of the page to delete the holidays you selected.
====Edit Existing Holidays====


By clicking on the title of a holiday event you will be taken to a new page where you can edit that holiday's title, year, month and date. You can also remove the event from that page by clicking on the ''Remove'' button.
By clicking on the name of a holiday you will be taken to a new page where you can edit that holiday's name, year, month and date. You can also remove that individual holiday by clicking the ''Remove'' button.


At the bottom of the page is a link: ''Add New Holiday''. Clicking this will allow you to add a new holiday to the Calendar. The page you go to when you click on the link looks the exact same as when you edit an existing Calendar event.
====Add New Holidays====


You will be able to give the holiday a title, along with the day, month, and year of the holiday.
Beside the ''Remove Selected'' button, is the ''Add New Holiday'' button. It allows you to add a new holiday to the Calendar. That page looks very similar to the page for editing a holiday. First fill in the name, or title of the holiday. Then for the Year fields, first there is a dropdown menu. If your holiday falls on the same date every year, choose Every Year.  


== Calendar Settings ==
Otherwise, choose whichever year you are configuring; and then set the date for that year. Remember that you will need to set a separate holiday for each year for which you have configured the calendar, if your new holiday does not fall on the same day each year. So if you set up a ten year range of calendar years, on the ''Calendar Settings'' page, you will need to set up ten of this holiday -- one for each year.  
In the Calendar page you can control various settings relating to the calendar on your forum. Such settings as, enabling and disabling the calendar, the membergroups allowed to: see the calendar, create events, and edit any events. Along with the default board to post calendar events to and the color that events, birthdays and holidays will show as on the board index, and much more.


*'''Membergroups allowed to view the calendar''' - Check the groups that can see the calendar.
When you finish with each holiday, click the '''Add''' button in the bottom right corner. Now you should see the new holiday in the list, and also on the calendar, depending on how you configured holidays on the Settings page.
*'''Membergroups allowed to create events''' - Check the groups that can post new calendar events.
*'''Membergroups allowed to edit their own events''' - Check the groups that can edit events that they personally have posted.
*'''Membergroups allowed to edit any events''' - Check the groups that can edit events that anyone has posted.
*'''Max days in advance on board index''' - Show how many days in advance to show calendar events on the board index. For example if this is set to 7, the next week's worth of events will be shown.
*'''Show holidays''' - Select between showing holidays nowhere, in calendar only, on the board index only, or both the calendar and board index.
*'''Show birthdays''' - Select between showing birthdays nowhere, in calendar only, on the board index only, or both the calendar and board index.
*'''Show events''' - Select between showing events nowhere, in calendar only, on the board index only, or both the calendar and board index.
*'''Default board to post events in''' - Choose the default board to post events in.
*'''Show days as link to 'Post Event'''' - This will allow members to post events for that day, when they click on that date.
*'''Allow events not linked to posts''' - Check to allow posting of events that are not posted as a topic.
*'''Show linked events in topic display''' - Check to show a link to the event of the event's topic.
*'''Minimum year''' - Select the "first" year on the calendar list.
*'''Maximum year''' - Select the "last" year on the calendar list.
*'''Birthday color''' - Select the color of the birthday text.
*'''Event color''' - Select the color of the event text.
*'''Holiday color''' - Select the color of the Holiday text.
*'''Allow events to span multiple days''' - Check to allow events to span multiple days.
*'''Max number of days an event can span''' - Select the maximum days that an event can span.


{{ {{Localized|As an administrator 2.1}}}}
{{ {{Localized|As an administrator 2.1}}}}

Latest revision as of 01:07, 1 January 2024

Under construction-48.png Work in progress, expect frequent changes. Under construction-48.png

Please see SMF1.1:Calendar administration, SMF2.0:Calendar administration or SMF2.1:Calendar administration depending on the version of SMF you are using.

The Calendar feature allows administrators to provide, or not provide, a calendar for the forum. Holidays can be managed in great detail, including many other options for customizing the calendar. Once enabled, it allows members to post special events, if the administrator has given them permission. If you are a member trying to use the calendar, you can find instructions on the Calendar manual page.

To enable the Calendar, check Admin Center > Forum > Calendar > Calendar Settings > Enable calendar. Then click the Save button in the bottom right corner. After that, more administrative options will appear on that page, and as well, another page, Manage Holidays will show up. Then you will find the Calendar itself in the main menu, at the top of the forum index page.

Calendar Settings

These are all the options and settings which will appear after you have enabled the calendar.

  • Membergroups allowed to view the calendar - Check the member groups that you want to be able to view the calendar.
  • Membergroups allowed to create events - Check the member groups that you want to be able to create new events in the calendar.
  • Membergroups allowed to edit their own events - Check the member groups that you want to be able to edit the events they created.
  • Membergroups allowed to edit any events - Check the member groups that you want to be able to edit any events in the calendar.

  • Max days in advance on board index - Show how many days in advance to show calendar events on the board index. For example if this is set to 7, the next week's worth of events will be shown.
  • Show holidays - Select from the dropdown menu where you want holidays to be displayed.
  • Show birthdays - Select from the dropdown menu where you want birthdays to be displayed.
  • Show events - Select from the dropdown menu where you want events to be displayed.
  • Allow events to be exported in iCal format - Checking this option exports a text file in the iCal format, that can be imported into other calendar applications.

  • Default board to post events in - Events can be posted in any board, but this sets the default board in which you would like events to be posted.
  • Show days as link to 'Post Event' - Clicking this allows users to be able to click a day in the calendar to create a new event (as long as they have the proper permission). Otherwise, they can click the Post Event button to create a new event.
  • Allow events not linked to posts - Checking this option allows users to create new events which are not also posted in the forum. The option Show linked events in topic display must be disabled, to prevent the link from showing in the forum message.
  • Show linked events in topic display - Checking this adds a link to the new event, above the message in the forum that announces the event. Otherwise, the event is still announced in the forum, but without a link to the calendar event.

  • Minimum year - Select the earliest, or "first" year for your forum's calendar.
  • Maximum year - Select the latest, or "last" year for your forum's calendar.

Note that the larger span of years that you create, the more holidays you will have to manage on the Manage Holidays page. For example, Mother's Day is on a different date every year. So if you set up ten years worth of calendars, you will have ten Mother's Days to manage.


  • Max number of days an event can span - Select the maximum number of days that an event can span. Set to zero for no limit.

  • Disable three Month Blocks - Checking this box prevents the three small calendar month blocks from showing on the left.
  • Show Week links - This shows a link at the far left of each week, which displays only that week, if you click on it. Choose from the dropdown menu, in which calendar you want these links to show up. It is a graphic link rather than a text link.
  • Show Previous / Next Month Links - This places graphic links to the previous and next month, for easy navigation.
  • Short Day Titles - This shortens the days' titles, for example "Mon" for "Monday".
  • Short Month Titles - This shortens the months' titles, for exampe "Jan" for "January".

Be sure to click the Save button in the bottom right corner when you finish setting your options.

Manage Holidays

On Admin Center > Forum > Calendar > Manage Holidays page, you can edit existing holidays and add new ones.

This is a listing of all of the holidays already added to your forum's Calendar. There are three columns: the Name of the holiday, the Date of the holiday, and a checkbox. With the checkbox and Delete Selected button you can remove any holidays that you do not want.

Edit Existing Holidays

By clicking on the name of a holiday you will be taken to a new page where you can edit that holiday's name, year, month and date. You can also remove that individual holiday by clicking the Remove button.

Add New Holidays

Beside the Remove Selected button, is the Add New Holiday button. It allows you to add a new holiday to the Calendar. That page looks very similar to the page for editing a holiday. First fill in the name, or title of the holiday. Then for the Year fields, first there is a dropdown menu. If your holiday falls on the same date every year, choose Every Year.

Otherwise, choose whichever year you are configuring; and then set the date for that year. Remember that you will need to set a separate holiday for each year for which you have configured the calendar, if your new holiday does not fall on the same day each year. So if you set up a ten year range of calendar years, on the Calendar Settings page, you will need to set up ten of this holiday -- one for each year.

When you finish with each holiday, click the Add button in the bottom right corner. Now you should see the new holiday in the list, and also on the calendar, depending on how you configured holidays on the Settings page.

Main

Configuration

Forum

Members

Maintenance

Miscellaneous




Advertisement: