The Basic Meeting List Toolbox

Additional Configuration Parameters

Click Here to Go to the Intro PageCAVEAT EMPTOR

Before we get started, we need to warn you that the following material is not for the faint of heart. It involves custom configuration of your auto-config.inc.php file, which, if not done done properly, can HOSE YOUR ROOT SERVER.

There, we said it. Don’t do this, unless you are a Webservant, setting up a Root Server.

The Basics

There are some addtional parameters that can be added to your auto-config.inc.php file to add further customization to your root server. These features aren’t able to be added when initially setting up your Root Server using the installer wizard. We will go over them and note at which version of the Root Server they became available.

Include Service body contact emails in semantic response

This will be displayed in the switcher=GetServiceBodies semantic response. In order to enable this capability, you need two things:

  1. Root Sever Version 2.10.2 or greater; and
  2. An additional line, manually entered into your auto-config.inc.php file (the file created when you installed the server).

The first part is fairly basic. Get and install the correct version of the Root Server.

For the second part, you need to open your existing auto-config.inc.php file with a text editor, and add the following line:

$g_include_service_body_email_in_semantic = TRUE;

Once these conditions are met, you will now see an additional field of contact_email if it is set.

Display fixed set of states/provinces in a dropdown menu

This will allow you to display a fixed set of states/provinces when editing meetings in a dropdown menu rather than a free form text field. In order to enable this capability, you need two things:

  1. Root Sever Version 2.12.0 or greater; and
  2. An additional line, manually entered into your auto-config.inc.php file (the file created when you installed the server).

The first part is fairly basic. Get and install the correct version of the Root Server.

For the second part, you need to open your existing auto-config.inc.php file with a text editor, and add the following. This will be an array of your States or Provinces. This example would show all of New England.

$meeting_states_and_provinces = array('CT','MA','ME','NH','RI','VT');

Once these conditions are met, you will now see a dropdown in you meeting editor where your State/Province text field was.

A couple of notes to consider
This array will not be sorted automatically and should be entered in the order you wish to show up.
You will want to make sure that your database is cleaned up of any improperly entered State/Province fields. You can get a list of all the different State/Province fields in your database accessing the following semantic respone switcher=GetFieldValues&meeting_key=location_province If you don’t do this any field values that aren’t in the $meeting_states_and_provinces array will show up as empty values.

Display fixed set of Counties/Sub Provinces in a dropdown menu

This will allow you to display a fixed set of counties/sub provinces when editing meetings in a dropdown menu rather than a free form text field. In order to enable this capability, you need two things:

  1. Root Sever Version 2.12.5 or greater; and
  2. An additional line, manually entered into your auto-config.inc.php file (the file created when you installed the server).

The first part is fairly basic. Get and install the correct version of the Root Server.

For the second part, you need to open your existing auto-config.inc.php file with a text editor, and add the following. This will be an array of your Counties or Sub Provinces. This example would show all of New England.

    $meeting_counties_and_sub_provinces = array('Barnstable','Berkshire','Bristol','Dukes','Essex','Franklin','Hampden','Hampshire','Kent','Middlesex','Nantucket','Newport','Norfolk','Plymouth','Providence','Suffolk','Washington','Worcester');

Once these conditions are met, you will now see a dropdown in you meeting editor where your Counties/Sub Province text field was.

A couple of notes to consider
This array will not be sorted automatically and should be entered in the order you wish to show up.
You will want to make sure that your database is cleaned up of any improperly entered Counties/Sub Provinces fields. You can get a list of all the different Counties/Sub Province fields in your database accessing the following semantic respone switcher=GetFieldValues&meeting_key=location_sub_province If you don’t do this any field values that aren’t in the $meeting_counties_and_sub_provinces array will show up as empty values.

This link contains a script that can generate the required setting with all values from your root server.
https://bmlt.charlestonna.org/countiesGenerator.php

support for weeks starting on days other than sunday (for sorting)

  1. Root Sever Version 2.8.22 or greater; and
  2. An additional line, manually entered into your auto-config.inc.php file (the file created when you installed the server).

The first part is fairly basic. Get and install the correct version of the Root Server.

For the second part, you need to open your existing auto-config.inc.php file with a text editor, and add the following line:

$week_starts_on = 1;

With “1” being Sunday, and “7” being Saturday.