A combination of the actual characters and the way the text is loaded onto your browser's page means that these characters have to be stripped from the caption text when you are editing an item. If they are not removed, they 'break' the form.

There is no problem inserting these characters into the caption input boxes and saving them - they will appear correctly to your web audience.

You first need to upload the file onto the server:

1. Go back to the main admin menu and select 'File uploader' from under the 'Site operation' column
2. Upload the file(s) into either the 'uploads' folder or the 'archive' folder (it doesn't matter which one you choose, just remember your choice!).  Make sure that the name of the file you upload has no spaces in it (remove them or replace with the underscore character) and that it has a suffix (e.g. .doc, .pdf etc).

Go back to your news item:

1. Highlight the word/phrase onto which you want to place the link to a file
2. Click on the 'Insert edit/link' icon that will appear on the toolbar (it looks like a chain link).  A popup layer will appear
3. In the 'Link URL' box, type in the name of the folder you uploaded the file into, followed by a forward slash, followed by the name of your file (e.g. uploads/mytest.doc)
4. Click on 'Insert' (there is no need to alter/change any of the other settings/options in the popup layer)
5. The task is done.   Save/Submit the news item when you're ready.

The ID of your YouTube video is most easily found from its URL.  When you are viewing the video on the YouTube site, the ID is the collection of letters and numbers that follow the 'watch?v=' part of the URL.

For example, in the URL 'http://www.youtube.com/watch?v=OBrwFTYrlc4&feature=grec_index', the playlist ID of the video is 'OBrwFTYrlc4' (notice that the & character is NOT included).

'Output places' refer to different news pages on the same site.

It is often necessary to have more than one news output page on a site - for example, where two major groups share the same site, and want to have their own physical news page in their 'part' of the site.

The output place option allows the administrator to direct a news item to the correct news page.

This option is rarely needed to be changed and should never changed without first contacting the Webmaster to outline your news output requirements.

• pdf files are assumed to be present in the /archives folder
• Just enter the name of the file, NOT the directory
• If you have more than one file, separate each filename with an asterisk (*)

This requires you to manually wrap a modified link (i.e. an "a" tag) around your link text so that we get something that looks like the link shown in the image below:

You have to use the HTML mode of the page editor to enter the necessary code - click on the HTML icon:

The HTML source editor will appear - and what you need to do is to manually enter the necessary tag information:

The HTML code is expanded in the following image which also shows the origin of an important part of the code - the YouTube video ID.

You can have as many of these tags as you want on a single page.  The basic structure of the tag remains the same, apart from the YouTube video ID - which you get from the URL when you're looking at the video on YouTube.

Once you've finished entering the code, click on the "Update" button on the HTML source editor.  It will disappear and you'll return to the "normal" editor.  Make sure that you click the "Save/Add" button to save your updated code to the database.

The -1 value is used when you don't want a category to appear in the main FAQ page list (e.g. you may be using that category on another page).

The FAQ display pages are currently 'hard coded' to make all images 100px wide. You should, therefore, have images that are at least 100px wide (otherwise they will be stretched to 100px). Wider (larger) images will be 'squeezed' down to 100px - but you should use excessively wider images as the 'squeezing' will make the image unclear and poorly defined.

The main difference is speed - allocating a qualification to FAQs is faster, but it does depend on the relative number of FAQs to qualifications on the site.

The content of the 'Answer' is immediately visible to the person viewing the FAQ.  The content of the 'Supplemental answer' is initially hidden but its presence is signalled by a 'more »' string appearing immediately after the 'Answer'.  When the user clicks on the 'more »' the content of the 'Supplemental answer' is toggled into view.

Left click the existing text and an "inline text editor" will appear.  Make the adjustments to the text and click "Save".

The wide format slideshow displays text and an image in adjacent 'columns' on the page, with a navigation element to move from one slide to the next.

The image should be 450px wide (wider images can be used, but they will be 'squashed' to a 450px width - and probably lose viewing quality as a result).

First, do NOT delete the student's name from the database - if you do that, there will be no records left at all about the student.

The correct action is to select the "Withdrawn" option of the "Status" option in the bottom section of the user's records and then click SUBMIT. 

The student will no longer be able to log into the teaching site.  The next time you check the student's records, you'll find a date appear at the top and bottom of their record relating to the date at which you withdrew them from the system.

This information is recorded as part of each user's records.   Note that the word used to describe the payment type is a language variable; its default value is 'fee' - and this is the term used in the following steps:

1. Select the user for whom you wish to record this information
2. Move to the 'Payment details' section in that user's record
3. Click on the 'Full fees paid' box.  This is the minimum amount of information needed.
4. If you wish to enter in the dates when the invoice was sent, the payment received and the receipt sent, click in the input boxes of the next three form elements - a calendar will appear each time.
5. Clicking on the email icon next to "Date receipt sent" causes a new window to appear containing a form for emailing the user that his/her fees have been received.

When the "Full fees paid" box is switched on, any downloadable items that require payment (e.g. study guides) will become immediately available to the user through the "units" page.

doLV is the date of the student's last visit (logon) to the site.  If the student has never logged into the student zone, a dash ("-") will appear.

dbID is only useful for the WebMaster - it is the database ID number for the student.

1. You should take the image in portrait mode (rather than landscape mode)
2. Try to get as much of the user's face in the picture as possible
3. Keep in mind that the image you take will be proportionately re-sized to about 125 px wide after you've uploaded it onto the site
4. The name of the image will be automatically changed to the user's ID number
5. All instances of this user ID will be updated with a record of the same image
6. You can upload *.jpg, *.gif, or *.png image files
7. The uploaded and processed files are stored in the "faces" subfolder of the main "images" folder
8. The processed image will also appear in the user's unit standards records page

To upload the image, follow these steps

1. Click on the upload icon that appears to the right of the user's first name input field
2. Select the file you want to upload using the dialogue box that will appear
3. Once the file is uploaded and processed, close the upload box
4. The processed image should appear on the right hand side of the page

An aggregated quiz is made up of 2 or more standard quizzes.  You can not create an aggregated quiz if there are no existing standard quizzes.

An underlined answer (or answers) signals the correct answer(s) to the question.

This link allows a user to take the quiz from the RudderLive platform without being logged in.  If your quiz is formative and you don't need to collect data on who has attempted it, then integrate the remote access link into your written or online study material.

The first number is the number of questions available, the second is the number of questions selected, and the last value is the number of questions expected.

1. Click on the 'Manage training group lists' option
2. The names of students allocated to you are ticked (Fig. 1)
3. Those allocated to another staff member are grey and in italic font (you can override this allocation by clicking on the student's name)
4. The names of unallocated students are in black font and are unchecked
5. You can allocate new or un-allocate existing students by clicking on their name (or clicking in the checkbox next to their name).

If you intend using the glossary auto-quiz, it is important that:

1. You describe the word in the first sentence of the meaning/explanation as only the first sentence is used in the auto-quiz.
2. You do not repeat the term in the first sentence of the meaning/explanation. For example, if the term was 'sprit rig' then

• write 'A boom that extends upward from the mast to the topmost corner of a quadrangle sail'.
• do NOT write 'A sprit is a boom that extends upward from the mast to the topmost corner of a quadrangle sail'.

• There must be no spaces in the name of the image file. For example, 'big fish.jpg' is wrong; 'big_fish.jpg' or bigFish.jpg is OK.
• The thumbnail image must have the string '_sm' appended to its name eg. 'bigFish_sm.jpg'

The 'Edit or delete a word' allows you to quickly call up a word to edit or delete it.

However, the fastest option is to though the 'List (and edit) the words' option.This option provides you with an interface through which you can list all the words for a given letter on the screen.When you hover over each word, an 'Edit' icon and a 'Delete' icon will appear for you to initiate the course of action you want to take.

You need two sizes for each image

• The thumbnail image is 100 px wide
• The main image should be no wider than 400 px

Click on this link to first list the folders containing images and then click on a folder to view the images within that folder.

Over over each image to see a preview of the image.

Copy the pathname of the image you want

• highlight the image's name with your mouse.
• Right click and select "Copy" from the menu that will appear
• Copy the pathname into the "Image URL" box of the Insert/edit image function on hte editor's toolbar.

1. Click on "Allocate submenu items to classes
2. Select the class (qualification) for which a certain navigation item isn't showing and click "SUBMIT"
3. Tick the item in the list that is not turned on (or untick it if you want to turn it off) and enter a number that represents the RELATIVE order you want the item to appear.
   For example, if you want the item to appear after an existing item that has a list order of 7, but before another item that has a list order of 12, then you need to enter a number greater than 7 but less than 12.
4. Click "SUBMIT" to complete the task.

The checkboxes in the first column are associated with the staff details that will be listed on the public side of the site (in the Contact page).

The checkboxes in the second column control the details viewable within the registered access-only part of the site

The master switch checkboxes at the top of these columns control whether or not any details at all are displayed.

The default (recommended) dimensions of the image are 125px wide and 150px high. The image is used in the main "contacts" or "about us" pages.

While the image can be stored in any folder, its default folder is the "skin" folder. If you upload an image through the image loader associated with this field, the image upload process will automatically resize your image to 125px wide.

The image must be 50px wide x 60px tall.  It is used in the "contacts.asp" file (if your site uses this file)

Use the image upload function within the wizard - it is activated by clicking on the uploads icon in the Image field of the form.

Click on the image preview icon A list of images in the 'skin' folder will appear.

Hover over the name of each image, and a preview of that image will appear.

Click on the name of an image and that name will be transferred into the Image field (and the list of images will disappear).

The principle role is used to filter staff from various functions on the site.

1. The Course Coordinator can view and edit the records of all students
2. The Trainer can only view (and not edit) the records of students assigned to them
3. A Field Officer can view and edit the records of students assigned to him/her
4. Administrators can view and edit the records of all students using the site. 

The listing order controls the order of presentation of the person's name in 'Contact us' sidebar and the main 'Contacts' page.

The campus variable is used for teaching sites that have one or more defined classes and where the tutor needs to log into the class site.

Under these circumstances, you must add 'student IDs' into the boxes alongside the class/classes into which the tutor will be logging into the site.

If the site is a non-teaching site or it is a teaching site with no class structure (e.g. a site for apprentices), then just select either of these options for Campus.  You do not have to add any student IDs against the groups/classes/qualifications listed.

The "Group identity" variable is rarely used.  It controls the situation where two different groups of people - operating from the same site - have their own mutually exclusive set of staff pages.  The value of the "Group identity" is used to ensure that the correct individuals are listed on the correct group staff pages.

The value is determined by the Webmaster.   Its default value - when it is not being used - is zero.

This level controls what menu options the person will be able to see/access from the administration homepage

Group identity is a loosely defined switch that allows you to organise staff into groups for presentation on different pages on the site.

The meaning of the values you enter to allocate staff into one group or another is one that you need to remember.

You will need to contact the WebMaster to get the groups presented on their respective pages.

The default value is 0.

The security system operating within the staff details manager follows these rules:

1. You can only edit your records or those of staff with a lower security level than the one you are on.

2. You can only edit the records of your colleagues if you have a full level security password.   If you don't know what that is, then you don't have one.  Contact the Webmaster or someone in your group with full security clearance for more details.

When you are editing your records and cannot see a security level section in the form, it means that you don't have a sufficient security level to upgrade your own level.

In this circumstance, you must contact the person(s) in your organisation that has the necessary security level needed to change the security level of other individuals.

1. Click on "Select major groupings"
2. Check the major groups that you wish to have available on your web site
3. Click the "Submit" button
4. A list of the major sections will appear, along with a URL (web address)
5. Click on that web address to copy it into your computer's memory
6. You can now paste the address into your webpage (or into another file for later use)

1. Click on "Select items within major groupings"
2. Check the items within the major groups that you wish to have available on your web site
3. Click the "Submit" button
4. A list of the major sections will appear, along with a URL (web address)
5. Click on that web address to copy it into your computer's memory
6. You can now paste the address into your webpage (or into another file for later use)

1. Click "Select individual items"
2. All the items available in each major group will be list, along with their own URL
3. Click on the URL of the item(s) you want to use to copy the link into your computer's memory
4. Paste the link into your web page

Most of the functions have been turned off as they are not necessary for the preview window.

A link - for the purposes of this wizard - can be the address of another website, a link to a document stored on your Prolearn site, or a link to video or some other multimedia resource on your site or on another site (e.g. YouTube).

Sorry, but you must have at least one subcategory for each category.  Just name the subcategory something like 'General' and use it.  If you do not want the subcategory name to be listed in the output, name the subcategory 'No label'.

The links manager can handle three different "collections" of links: links to documents stored on the server (e.g. factsheets), links to videos stored anywhere, and links to other websites. With this page type, all links in the database (provided they have been activated for publication) are presented when the basic links page is used.

However, there will be instances where only a subset of the links are wanted to be displayed. For example, the links database might contain links to other internet sites and links to documents (e.g. factsheets) stored on the site, and links to YouTube-hosted videos. In this situation, you would set up a page type called "Links" and associate it with the categories you are using for this set of resources. You'd create a new category (or categories) to organise your documents and assign these to a page type called "Documents" (or whatever). You'd do the same for the video links.

These subsets of links within the database can then be easily identified and presented on different pages or sections of your website.

1. Click "Enter new video items"
2. Enter a title for the video(s)
3. Enter a description (if appropriate)
4. If you want to show a single clip or a set of clips you've found, enter the YouTube ID and a title of each clip into the "Custom YouTube playlist box. You must separate the ID and the title by an asterisk (*) and each set of ID*title must be separated by a semi colon. (e.g. hte82dsn*my title for the first one;8_hfadmls*my title for the second one;)
5. If you have already created a playlist (e.g. using from within your YouTube account), enter the playlist ID into the YouTube playlist ID.
6. Select category/subcategories and audiences as normal.

There are several fields in the editor - some of them are used for all three types of links, while others are specific to one or two link types.

1. Click on 'Order item listing within categories' from the main menu
2. Click on the category within which you wish to manage the listing order. The items within that category will appear along with a list order box.
3. Enter the order sequence you require and click 'Submit'.

These menu items are used to set up different output pages for different categories created within the links manager.

You should ignore this menu item - its use depends on the WebMaster "hardcoding" elements of the targetted output page.

1. Find the link by clicking 'Edit an existing item' and then selecting the category within which the link is stored.
2. From the list of items that will appear, hover over the item you want to delete.
3. Click on the delete icon  that will appear on the left hand side of the row
4. The confirm icon will appear.  Click on this to delete the item.
5. If the deletion is successful, the system will post a confirmation message at the top of the list.
6. At about the same time, the item will disappear from the list.

If you are entering a general or document link, you have the opportunity to create a preformatted link to a document (i.e. a pdf file etc) residing on your site's computer or on another site's computer.

To create a link to a file on your site's computer - regardless of whether you are creating a new link item or editing an existing one, please follow these steps:

1. Click on the "reveal folders" icon next to the "File" prompt in the editor's form.
2. This will result in a list of files in the "Archives" folder being displayed in the (green) right hand panel of the page. 
3. Each file will be associated with a radio button.  Tick the button of the file you want associated with the link item you are working with.
4. Click on the [Transfer] link to copy the names of the file's name into your form.

Embed

An "embed" is designed for the embedded code that YouTube provides for its videos. 

Videos embedded in your page will download immediately once the page is loaded into the browser.  This means that if your page has more than one embedded link in it, all the videos on the page will download.  This could result in a slow page for your user, so in this case - where you want to have more than one or two videos on a page, you should consider using the playlist or custom playlist option.

Playlist

The playlist option provides a link to each video on your page.  This option differs from the "embed" system in that the videos are only downloaded when the user clicks on the link.  The video appears immediately below the clicked link. The playlist option can be used for one or many videos.

Custom playlist

The calendar style uses a conventional monthly calendar display with events listed within the cells (days) of the calendar.  This style uses its own dedicated page for the calendar's display.

The countdown style uses one of a variety of phrases to countdown to events.  This style is usually displayed in the event box on the right hand side of both public and non-public pages.

The information you add to the "Title" field is only used in this wizard for indexing purposes.  It does not appear on the users' side.

To illustrate these items, let's take an examination as an example.  Let's call it 'the end-of-semester maths exam' and that we are 3 weeks away from the event taking place.

We first choose the type of countdown format we want that is appropriate to our event, and then write the countdown string need to match the format.

Taking each format in the order it's presented in the form, we have the following:

The countdown string format '... due in x [units]' (e.g. ... due in 3 weeks) is not suited to our event so we'll ignore it here. (Of course, if our event was the date when an assignment was due to be handed in, this countdown string format would probably be our favoured choice)

The 'x [units] to...' format is appropriate to our event.  So, we'd write, as our countdown string, 'the end-of-semester maths exam'.  The resulting output would be '3 weeks to the end-of-semester maths exam'.

The '... goes off offline in x [units]' is not really appropriate for our event so we'll ignore this one.

The '... is in x [units]' is appropriate for our event, so if we want to use this format, we'd write, as our countdown string 'The end-of-semester maths exam'.  The resulting output string will be 'The end-of-semester maths exam is in 3 weeks.'

This non-compulsory form item is for adding more detail to an event.  For example, if our event was a end-of-semester maths exam, we might want to provide additional information such as the place of the exam, the time of the day when it starts, its duration, the topics covered in the exam, and any special rules regarding the use and type of calculators for the exam. 

This information would be added to the 'Details' box.  Its presence in the output would be signalled by a 'More' link appearing after the countdown string.  When the user clicked on that link, the content of the details box would appear.

If you select "Public view", then the event will appear to everyone viewing the site, whether they are logged in or not.  In this regard, "Public view" overrides all allocations to selected audiences.

If you select one or more defined audiences - not including "Public view", then the event information will only be visible to people in those audiences you select once they are logged into the site.

You have two options, depending on the structure of your class or the group of students that use your site:

1. A group email is for students assigned to you - they may be from a range of different qualifications - but if you are their main contact person (i.e. your name appears in their 'Training details'), use the 'Send a group email' option
2. A class/tutorial email is used when either a formal tutorial group structure is being used, or you want to email an entire class or an individual(s) within that class.

1. Selecting the option

Select the 'group email' or 'class/tutorial group' option as best suits the student structure used on the site.

If you select the 'group email' option, only the names of those students assigned to you will appear.  In addition, those students in your group without email addresses will also appear but their names will be greyed out (so you can identify which of your students either don't have an email address or haven't updated their site details).

2. Selecting recipients

There are three options for selecting recipients of your email:
i. Select everyone on the list at once by clicking on the 'Select all [±]' link
ii. Click the letter on the alphabet to select all of those recipients whose surname begins with that letter
iii. Click the individual names of those you want to receive your post.

For large class/group sets, it is recommended that you do NOT send your email to more than ~100 recipients at any one time - the email client cannot handle the load.  Where you have a large set of recipients, we recommend you use the "alphabet" option to quickly select sub-groups within the larger set.

3. Write your email

Your name and email address will automatically appear under the list of recipients. You can change the contents of both fields if appropriate.

• You must enter a subject/title
• Enter your email message - DO NOT enter anything like 'Dear Sam' or 'Hello Class' - the string 'Hello first-name-of-person' will be automatically prepended to your message.

If you want to link an attachment to the email, click on the attachment link and select the file you need (you need to have already uploaded the file - you can do this from the 'File manager' option in the Message manager's main menu.

The name of the selected file will appear next to the "Attachment:" label (see image below)

You can hide the expanded list of files by re-clicking the "Select the file" link (i.e. it is a toggle switch).

When you are sure the message is completed and you've edited it for mistakes and typos, click on the 'Send this message/post' button to do just that.

If you are sending out your email to sub-groups of the main list  (e.g. everyone with a surname beginning with A, B, and C - when you need to reduce the number of recipients to ~100 each time), click the highlight A, B, and C links in the alphabet to de-select those recipients, and click the next alphabet letters to select the next batch.  You do not have to re-set the entire wizard and write your email again for the next group.

Contact:

1. Bruce MacKay (bruce@freshlearn.co.nz; 021 1051 301) for issues regarding the operation of this website.
2. David Manktelow (david@freshlearn.co.nz; 027 565 3043) for issues regarding support services from freshLearn
3. Jane Lamb (Operations Manager, Growsafe; jane.lamb@growsafe.co.nz) for issues relating to Growsafe policy and operational issues.

Generating a combined GROWSAFE/Approved Handler assessment is control by the checkboxes on the 'Your assessment and details' form in the Assessment tab of the manual (see highlighted area in the image below).

Once an assessment has been generated either as a Growsafe-only or a combined Growsafe/Approved Handler, the highlighted part of the form disappears by design (an explanation for this disappearance is provided at the bottom of this help item), making it impossible for the user to subsequently change their mind about what assessment they want to do and generate a different assessment. (Mostly, they've generated a Growsafe-only assessment and decide that they wanted to do Approved Handler as well).

Only an administrator can re-set their site information to allow such users to subsequently change their assessment 'combo'. 

The steps are:

1. Go into 'Manage assessments', find their name in the Results section and click on the brush icon (see screen capture below). This wipes all records of their current assessment choice from the database (whether they've passed it or not - they won't get any credit if they passed that assessment)
2. Tell the grower they can start over with the quiz generation (they don't need to re-login to do this - refreshing the tab is sufficient if they are waiting on the phone for you to fix the problem while they're still online).

Why does it have to be this way?  Why can't a grower change their assessment 'combo' at will?

Some background first.  When the 'Your assessment and details' form is submitted by the grower to generate an assessment, a series of programming steps occurs depending on the number of times the grower has submitted that form:

1. When the assessment is generated for the first time, a record of the questions that were asked is stored in the database (remember that every person's set of questions is different from each others as the questions are randomly selected from a series of question banks in the database).

2. When the person, having failed first time around, goes back to have another go, the code first looks in the database for any question records for that person.

• If those records exist, then the questions the person was first asked are asked again.
• If they don't exist, then a set of questions is randomly selected from the question banks and presented, and a record of those questions stored (as per point #1 above)

Why does it happen this way? We can't afford to allow 'someone' to repeatedly generate fresh sets of questions - 'competitors' in this space could quickly get a set of all the questions in our database and/or a full set of answered questions could be placed on the 'underground' for anyone 'in the know' to use when doing the online assessment, thereby rendering the whole assessment exercise/certificate renewal process void.

You need to re-set that grower's assessment questions record.

1. Go to the 'Manage assessments' section
2. Locate the grower's name in the Results listing
3. Click on the brush icon (see image below)
4. Click again on the blue shield (confirmation) icon that'll appear

The task is done.  Next time the grower enters the Assessment tab, he/she will be prompted afresh for the assessment 'combo' they want to attempt.  Once confirmed, the system will generate a completely new set of questions for them.

These are stored in the 'General Page Editor' section of the website.

If that option does not appear in the first column of the menu you see when you log into the administration section of the site, please contact the Webmaster.

DO NOT, under any circumstances, edit out the text "fname" in those email templates - that string is used during the processing of the email to insert the recipient's first name.

The pulsating label is to draw your attention to the fact that the trainer you selected for the Growsafe certificate has been automatically selected for the trainer for the AH certificate option - because these two certificates are usually dealt with together.

However, if this duplication is not correct for the particular grower whose details you are entering/updating, just change the AH selection to the correct trainer.

A date "flag" to confirm that the grower's AH certificate can be generated and sent appears in the "Approved Handler" tab of the "Assessments" page.

Look in the "Confirmed" column - if there is a date showing, you can generate and post the grower's AH certificate.

Warning: Do NOT be tempted to click on the live links in the first column (---).  These are used to update the "Confirmed" field in the database and are only to be used by the AH administrator.

A snippet is industry sector-specific content that is inserted into a fact sheet either automatically when the sheet is loaded ('auto show') or on demand ('click to show')

• An 'auto show' snippet is one that automatically appears in the fact sheet when the sheet loads. The content of the 'auto show' snippet is consistent with the sector group of the viewer.
• A 'click to show' snippet is one in which content is dynamically inserted into a fact sheet when the user clicks on a 'click to show' hyperlink - i.e. the content is 'on demand'. The link is 'intelligent' in that it will retrieve content appropriate to the user's sector group. Each link 'access' a snippet cluster, which is a set of individual entries in the database containing content relevant to each sector group.

There are two ways of entering new content, depending on whether you are adding a new link or adding sector content to an existing link.

• Click on the Snippet Editor tab
• To add sector content to an existing link, click on the [Add] button associated with the link you are working with.
• If you are creating content for a new link, then click on 'Create a new snippet/snippet cluster' at the bottom of the page
• Fill in the form that appears

• Click on the Snippet Editor tab
• Locate the snippet from the list that appears and take note of the ID number associated with it
• Click on the Core Editor tab
• At the position in the fact sheet that the snippet is to appear, insert a new line.
• Enter the string !DDXXXXX where XXXXX is the ID number of the auto show snippet. For example, if the ID number is 24, you will enter !DD00024

• Click on the Snippet Editor tab
• Locate the 'Click to show' snippet from the list that appears and take note of the ID number associated with it
• Click on the Core Editor tab
• Highlight the phrase/words that will form the text link from which the snippet is launched
• Click on the 'Insert/edit link' icon on the toolbar
• Select the 'drill' class from the dropdown list on the 'General' tab
• Click on the 'Advanced' tab
• In the 'Id' box, insert 'dd' followed by the snippet's ID number. ('dd' is case sensitive)
• Click 'Insert' to return to the editor.

That is by design - all links on the preview page are disabled.

You use the keyboard sequences of Ctrl-c (to copy), Ctrl-x (to cut), and Ctrl-v (to paste). The standard toolbar icons have been turned off - in a website editor, they are more trouble than they are worth.

• If your browser is Internet Explorer, they allow you to inadvertantly paste potentially damaging code into the website whenever you copy from a Word document and paste into the editor.
• If your browser is Firefox, you cannot use these functions unless you alter your browser's security functions - and this is not a straightforward procedure.

What is straightforward, however, are the replacements to these icons.

• To copy something from Word (or any other wordprocessor) and paste it into the online editor:
  1. Copy your text in your normal way.
  2. Click in the main content space of the online editor
  3. Paste the text into the editor using keyboard sequence of Ctrl-v (Ctrl-v means depress the Ctrl key and, keeping it depressed, tap the "v" key)
• To copy something from within your document in the online editor to somewhere else in the document:
  1. Highlight the area you want to copy by dragging your mouse from the beginning to the end of the section
  2. Copy that section of text by using the keyboard sequence Ctrl-c (i.e. depress the Ctrl key and with it depressed, tap "c").
  3. Position your cursor at the place in the document where you want to copy the section to (i.e. paste)
  4. Paste the copied section using the keyboard sequence Ctrl-v.
• To cut something from within your document in the online editor and paste it somewhere else in the document:
  1. Highlight the area you want to copy by dragging your mouse from the beginning to the end of the section
  2. Cut that section of text by using the keyboard sequence Ctrl-x
  3. Position your cursor at the place in the document where you want to paste the section
  4. Paste the copied section using the keyboard sequence Ctrl-v.

There are two ways of entering text into the summary box (in the 'Footer info' section).

1. Use the auto-formatting feature which will create a bullet-point list. For this formatting to be triggered, you must separate the items by an asterisk. The first item will be treated as a sentence.
   Example: 'The main points to remember about the information in this factsheet are:*roses are red*violets are blue*you know the rest'
   In this example, the 3 lines of the poem will be bullet-pointed and the first item ('The main points...') will be treated as a sentence.
2. Insert your own HTML codes (e.g. paragraph tags etc) to enter your own material.

There are two ways of entering text into the acknowledgements box (in the 'Footer info' section).

1. Use the auto-formatting feature which will create a bullet-point list. For this formatting to be triggered, you must separate the items by an asterisk. The first item will be treated as a title and placed in italics.
   Example: 'References*McDonald, O. 2007. Farming with chickens. Jour. American Broiler Soc. 23:11-14.*Smith, A. and J. Jones. 2008. The effect of stuff on things. Jour. Amer. Soc. Hort. Sci. 98:107-110'
   In this example, the first line will be italicised and the two references will start on new lines immediately below the title.
2. Insert your own HTML codes (e.g. paragraph tags etc) to enter your own material.

In this context, quotes are a block of text - usually a short sentence or sentence fragment - that is presented in large font and enclosed by 'large' quotes. Its role is to highlight an important piece of information within the text.

Quotes are easily formatted within the core or snippet editor. They can appear in 200 pixel wide blocks on the left or right hand sides of the text body, or they can be full width.

1. Create a paragraph containing the text at the position in the factsheet where you want it to start - the easiest way to do this is to have the text appear on its own line separated from the surrounding text.
2. Left click on any letter of the text to be quoted.
3. Left click on the Edit/Insert Attributes icon (bottom right hand side of the editor's toolbar - a hand holding a document)
4. From the drop down list of the 'Class' attribute, select either 'rquote', 'lquote', or 'fquote' (for right, left and full width respectively).
5. Click 'Insert'
6. Nothing will appear to change within the editor - the quote format will be applied dynamically as the page is loaded into users' browsers.

You may or may not see this option which appears in the author info section of the core editor - its appearance depends on your security level in the wizard.  The initiating author is the name of the person who has primary control over the factsheet.  It is not necessarily the author of the factsheet - although often they are one and the same person - but it is the person who has primary access to the factsheet for editing purposes. 

The initiating author is primarily a filter, which ensures that only you - and not other people with access to the factsheet editor - can access your factsheet material.    Please note, however, that staff with full security access (e.g. the WebMaster) will also be able to access your material - their security level overrides that of the "initiating author".

The following 'rules' apply to images on this site:

• Photographs must be in a *jpg format
• Line drawings, with or without colour, must be in either a *.gif or a *.png format
• Images should be no wider than 600px
• Images should be no deeper than about 400px
• An image less than 100 pixels wide is usually too small to display its intended 'story'
• Images intended for left- or right-hand side positioning should be either 200 or 400 pixels wide
• The file size of any image should not exceed 40kb
• Copy the images onto the server and into the appropriate folder using the 'Multimedia manager' (> Manage images > Upload images) listed on the main menu.
• You link to images from within the editor by clicking on the image button and entering the string ../images/xxxx/zzzz.zzz - where xxxx is the name of the folder into which you uploaded the image and zzzz.zzz is the name of the image.

Positioning images on the page requires a class statement to be manually added to the HTML image tag. You can do this after you've inserted an image tag using the WYSIWYG editor, or directly when you enter an image tag through the HTML editor.

The HTML image tag is structured as:
<img class="___" title=' src="../images/folderName/fileName" alt=' width="xxx" height="xxx" />

In order to be positioned on the page, the class statement must take one of four values:

• imgposf = position in the left hand side column (the first column) of a 2 column layout (max. image width = 200px)
• imgposr = position on the right and wrap text
• imgposl = position on the left and wrap text
• imgposc = centre on the page, no wrapping

Text entered into the title statement will be extracted and placed immediately beneath the image in the form of a title. The title statement will be automatically inserted into the alt statement, if the latter is empty.

Note that adjacent images in the first columnn of a 2 column layout will overlap each other if they are too close (vertically) - the only solution is to alter the position of the image within the text.

Zoomable images are ones which, when clicked, expand to a larger version of that image.

To create such an image, prepare the code for the image in the normal way (see the item above), with the only difference being that the class statement must take one of four following values:

• imgposfz = position in the left hand side column (the first column) of a 2 column layout (max. image width = 200px)
• imgposrz = position on the right and wrap text
• imgposlz = position on the left and wrap text
• imgposcz = centre on the page, no wrapping

Obviously, both versions of the image must be loaded into the same folder on the server. They must share the same root name; the larger version must have a "_l" added to the end of its name. For example, "sprinkler.jpg" and "sprinkler_l.jpg".

Text entered into the title statement will be extracted and placed immediately beneath the image in the form of a title. The title statement will be automatically inserted into the alt statement, if the latter is empty.

This positioning and image titling is done by javascript on the user's side only - the functionality is not currently available on in the preview tab of the editor

Note that adjacent images in the first columnn of a 2 column layout will overlap each other if they are too close (vertically) - the only solution is to alter the position of the image within the text.

1. Copy the name of the file of the factsheet (Utilities > Fact sheet files); it will be of the general form 'fsXX-YY.asp'
2. In the core or snippet editor, highlight the word or phrase to which you wish to attach the hyperlink
3. Click on the link icon and in the 'Link URL' input element, paste the filename of the fact sheet.
4. Click 'Insert'.

• All these tags are invoked using the links icon on the toolbar.
  1. Tool tip
     This link takes information entered in the title element of the 'a' tag and displays it in a dialogue box when the user hovers over the link.
     
     Enter '#' for the href element, select 'tip' as the class, and enter the information into the title field e.g.
     
     <a class="tip" title="This information will be displayed to the user when he/she hovers over the link" href="#">some word or phrase<a>
     
     
  2. Dynamic glossary link
     This version of the 'a' tag is used to give the user an explanation of the word or phrase about which the 'a' tag is placed. The word/phrase must already exist in the site's glossary (use the 'Glossary wizard' to enter or check the presence of the word).
     
     Enter '#' for the href element, select 'glossary' as the class, and enter the word to be searched for into the title field e.g.
     
     <a class="glossary" title="climate change" href="#">climate change<a>
     
     
  3. Graybox/layer
     This is used for external links that you want to load "in" the current page, so that the user does not move away from the site.
     
     Enter the external address (complete with http://) for the href element and select 'sbox' as the class e.g.
     
     <a class="sbox" href="http://en.wikipedia.org/wiki/Climate">climate<a>
     
     You can control the width and height of the layer by adding an ID of the form 'wh_www_hhh' (e.g. wh_500_600). The width value must precede the height value.
     
     
  4. Link to other pages on this site
     As the title suggests, this link is used to link to other pages in the current ebook.
     
     Locate the filename of the page to which you want to link (a dynamic list of site pages will soon be available from within the Utilities tab).
     
     Highlight the word or phrase you wish to hyperlink
     
     Click the link icon from the toolbar
     
     Enter the filename/URL into the "Link URL" box
     
     Click "Insert"
     

The glossary is managed through the glossary check/edit utility.

This is a bit messy, but if you follow the information here, you should be OK.

The basic string is:

factsheets*../factsheets.asp*Name-of-section*../factsheetlists.asp?id=sectionID*Generic-title-of-factsheet

The Name-of-section and sectionID values can take one of the following pairs:

• frost 2
• irrigation 3
• spraying 7
• compliance 8
• climate change 9
• weeds 10
• weather 11

So, for the weed "Hawksbeard", you would enter:

factsheets*../factsheets.asp*weeds*../factsheetlists.asp?id=10*hawksbeard

Notice that the breadcrumbs are written in lowercase.

Check that you've entered a URL for that category in the factsheet section configuration option in the Factsheet wizard.

Nothing is wrong - the sky is not falling.  You need to have changed your work by more than 10 characters before the updated stamp is added to the headers.

No - these labels are automatically stripped from the form before it is sent to the server for final processing.

This is for sorting purposes - which cannot be achieved using the information in the citation fields

1. The images (if used) are presumed to be in the '/images/' folder.  There is NO need to include the 'images' pathname with your filename.
2. The target file must be created by the Webmaster.

It depends on where the title is being displayed.

1. If it is being displayed in an index page, then the title is controlled by what appears in the "Title" field of that "item" from within the BPG Manager wizard.

2. The words of the title that is displayed at the top of the actual factsheet are taken from "Mobile nav text" field which appears in the "Parentage & page structure" section of the page editor within the TechBox Manager wizard.

Insert the following code:

The name and size etc of the video clip will be inserted into the iframe tag position. (You get this by following the "Share" and "Embed" information on the YouTube page.

The "211" string must be a unique string to the page - you cannot have more than one instances of id=v211 or videov211 on the page.  You should change the "211" to a unique string.

1. Generate the QRcode image that will be displayed on the desktop version of the home page (if required). This image should be saved in the "images" folder.
2. Create a XXX.css style sheet and create the top banner images on the basis of the prescribed banner heights.
3. Create a techbox_mobileXXX.css stylesheet
4. Create a text file (XXXhomepage.txt) for the XXX home page content.
5. Create a text file (XXXcontacts.txt) for contact information (about.asp).
6. If you selected the 'Specific' option to the 'Disclaimer notice' prompt when setting up the account, then create a text file (XXXdisclaimer.txt) for the site disclaimer.
7. Add/adjust the dodesktop.css file (this should be automated soon), paying particular attention to the height of the top banner.

1. Add a "pgname" variable (format it as "_abc") to the new page and feed it into the sbSelectNZWFilters.
2. In the site's main js file, add a "prepareFilter(pgname) to the pageinit for the new page.
3. In rwc_filters.asp (or its equivalent), add the expanded version of the pgname variable for the re-direct function (~line 102)

1. In default.asp (or whatever the page on which the techbox is going to be shown is called), update the subjectID number and pagetitle values
2. In scripts/site/bodybannernav.asp, allocate the new directory name (sPath) to the appropriate subroutine to get the correct banner appearing.
3. In scripts/site/new_pgContent.asp, allocate the new directory name (sPath) to the appropriate subroutine to get the correct content code presented.
4. In scripts/site/new_pgFooter.asp, allocate the new directory name (sPath) to the appropriate subroutine to get the correct footer code presented.
5. In scripts/site/new_skintools_common.asp, add an appropriate case (or append to an existing one) to have the correct session variables set up.
6. If this is a new account, make sure you add a "Guest User" to the class password in the sbPrepareSessionVariables subroutine in the above file.
7. In scripts/site/new_pgHeader.asp, allocate the correct header and .css files to the page

Enter "DELETE" in the tab label field of the tab you wish to delete and click on the "Save" button.

The field will be deleted from the database (although it will still remain visible in the editor until you reload the module).

1. A 'STP' is a Single Text Page.  This is exactly as the name describes - a single page occupying a single tab on the dashboard.
2. A 'MTP' is a Multiple Text Page.  This is a collection of 'pages' occupying a single tab on the dashboard.  A sub-navigation bar is automatically generated for each page; the bar is inserted at the top of the tab's content.
3. A "UTP" is a Utility Text Page.  Utility pages include the glossary, slideshow, quiz and downloads tabs. The text contents of a UTP are inserted into the tab "above" the output from the tab.  You would use a UTP page to insert information that describes the use or value of the particular utility page to the user.

You have to use the HTML editor for at least part of this task.

Give the image the id of "firstimage" - the code will do the rest.

This works slightly differently to the procedure used for slideshows etc.

Enter the string !DLXXDL! for a single link or !DLXX,XYDL! for two links (and so on).

The XX and XY are the download link IDs (you will have to get these from the File Transfers wizard)

Notice that if you have more than one link, the link IDs are separated by a comma.

The !DLXXDL! is expected to appear alone on its own line in the text e.g.

!DLXXDL!

Whenever you update the download files (using the File Transfers wizard), you need to update the page(s) in the Techbox that use the download files.

When you are creating a text page (to provide content for a set of tutorial links), you will be prompted for the display order.  

Within the selection you have to choose from appear the options "base tab" and "utility tab".

The "base tab" option is used for the first content of the first tab of the module.

The "utility tab" option is used for ????

Enter the class "dontsplit" in the element or elements surrounding container.

The basic structure is:

Accordion title here


...
... elements
...


The element options are tables or divs.

The 'dontsplit' class is not compulsory but is recommended else the columniser renders the first column of a split accordion structure inoperable.

You can enter this code in manually from within the HTML window, or select the "Accordion" template from the template option on the editor's menu bar.

A table is called by adding the string:

<div class="generatetable" id="DT00001"></div> or

<div class="generatetable_f" id="DT00001"></div> if you want the table to fit the full page width.

A set of links is called by adding the string:

<div class="generatelinks" id="DT00001"></div>

In both cases, the number (00001) is the ID of the dynamic table being generated or the link category ID. Both objects (tables and links) require the Webmaster to write code to link the calls to the database.

Enter a string of the type:

!TXname_of_fileTX!

onto its own line.

There are a couple of constraints:

1. You can only have one inserted file per page
2. The file is expected to reside in the textfiles folder

1. Link to techbox_ui.asp
2. For videos, append the string: ?id=doVideo&;item=x (where x is the ID of the video)
3. For slides, append the string: ?id=doSlides&;item=x (where x is the ID of the slideshow)

It is likely that you have selected a "wide format" slideshow - these can only be added to a "fullscreen" page.

The wide format slideshow displays text and an image in adjacent 'columns' on the page, with a navigation element to move from one slide to the next.

1. Get the link ID of the link you want to embed from the links manager
2. Prepare the hyperlink, setting the URL to #, the title to the link ID, and the class to getlink

The page into which the slideshow will be embedded must be formatted as a tutorial page with a single column (i.e. full width). 

Embedded slideshows will appear on the right hand side of the page.

A sideshow with images of about 400 px wide will take about about 50% of the page's total width.

On a blank line at the top of the page, enter

!SS12345

where 12345 is a zero padded five digit number containing the ID number of the slideshow (this is displayed in the listings in the slideshow wizard). 

For example, if the slideshow's ID was 85, you would enter:

!SS00085

1. Create individual files for each accordion element. Note that images embedded in the left hand column must either be centred or floated left (imgposr sends them to the bottom of the page!)
2. Set their display order as 'Utility'
3. Add a navigation element - this will be used in the accordion's headers
4. Have the files 'offline'
5. Create the page into which the files will be 'accordioned'
6. Use the structure !ACC1,2,3,4ACC! to create the accordion. 
7. Whenever you change the content of an individual file (step 1), you must open and re-save the file created in step 5.

These are connected to various page templates.

The green dots enclose a panel that will appear on the right hand side of the page

The red dots enclose a left hand side panel.

The page is probably being split into two columns and doesn't have enough p tags to do this.

This happens often when text from Word is pasted into the editor - instead of separating paragraphs with the p tag, it inserts to br tags instead.  Without more than 1 p tag, the javascript code cannot split the text between columns and it goes into a spiral.

The solution is to edit the page in HTML mode, replacing the double br tags for a close-p, open-p tag set.

1. A prospective employee or employer enters the details of the job sought/offered into the form on the "employment" page
2. The submitted details are saved to the database, but not made available online
3. An email is sent to the person submitting the information to confirm the submission - they must click a link in the email which sends a confirmation signal back to the database
4. When the confirmation signal is received, an email is sent to the BITO administrator. This email contains the details posted by the employee/employer and a final confirmation link.
5. If the details are in order, the administrator clicks a link in the email and the job sought/offered is turned online

When someone sends me a job posting to manually add to the site

You are more likely to use the "Edit a job listing" as it is expected that both seekers and providers of employment will enter their own details into the system from the employment page on the public side of the site

A continuous profile type has the available images circulating through a cycle - the speed of which is controlled by the csProfileRotationSpeed variable in the configuration file.

You cannot have both types operating on the site at once.

This tool is a central "clearing house" for tasks associated with the maintenance and development of both the client-side and administration-side functions and services of the web site.

Site administrators add "tasks" to the tool. The webmaster/developer is automatically informed and is "reminded" (by the tool) of tasks that need completing.  Once completed, the Webmaster/developer will close the "task".

To add a task, hover your mouse over the "Active tasks" toolbar and click on the "+" character.

The first column will be disabled, while input fields will appear in the task information boxes in the remaining two columns.

Administrators should fill in the description field with as much detail as possible to aid the developer address the issue or problem being reported.

Once a task has been created and entered into the database, it can be subsequently edited by clicking on its title in the "Active tasks" section.  Updates or edits to each section can then be made.  Changes to each section must be saved individually - hover your mouse of each section's toolbar and click the "Save" icon that will appear.

You don't have to use the "Next" or "1", "2" etc buttons at the bottom of the table of employer names.  To quickly find an employer, enter the first couple of letters of the employer into the search box.  This acts like a super filter and will quickly reduce the entire list of employers down to those who share the letters you've entered.

The list that is presented to you only contains those employers for whom comments have been made.

If you are just "one of the staff" on the site, you can only edit or delete comments that you entered.  

On the other hand, the site administrator can edit/delete any and all comments, regardless of who wrote them.

If the apprentice does not have an email address listed on the site, the system automatically creates a signature block on the generated email.

There are 10 steps:

1. Select the apprentice using the "View/manage an apprentice's progress" menu option
2. Choose the "Current units" option
3. If the apprentice has completed one or more of the current units listed, hover your mouse over the current unit's row and click the "Accept" icon that will appear in the "Manage" column of the table.
4. This unit's number, title and credits value will appear in the "Units signed off" box in the form. The data in the credit summary part of the form will also be updated.
5. Enter any comments into the "Progress" box
6. Enter any comments/instructions for the administration staff into the "Other comments" box
7. If the information is available in the database, the apprentice's email address and the name and email address of his/her trainer (if applicable), and your name and email address will already be present in the form. The content of the form will be emailed to the NZMITO administrator and to all those listed in the form.
8. Enter a date for the next visit (if appropriate).  If a date is entered, the apprentice will be reminded of this date whenever they log into the website.
9. Click on the "Store information/Send email" button to process the information and to send out confirmation emails.  A "busy" indicator may appear momentarily while the information is processed.  Do not click the button again.
10. The end of the processing will be signalled by the disappearance of the "busy" indicator and a short text informing you that the emails had been successfully sent.

There are 8 steps involved:

1. If the workbook and assessment files are available, then upload the workbook and assessment files for the new unit standard (click on "File manager (unit standards)".  Please note - the names of these files MUST follow this format:
   
   • Unumber_Workbook_MonthYear.pdf and Unumber_Assessment_MonthYear.pdf
   • For example: U10841_Workbook_June2009.pdf and U10841_Assessment_June2009.pdf
2. Click on "Add a new unit standard"
3. Fill in the required fields.
4. You must add content to the "Workbook file" and "Assessment file" fields.  Select the files by clicking on the [Files] link.  A popup window will appear. 
5. Click on the names of the workbook and assessment file for this new entry - click the workbook file first and then the assessment file.  The popup will then close and the files you selected will be loaded into their allotted input boxes
6. If you don't have the workbook and assessment files available, then select "blankWorkbookfile.pdf" and "blankAssessmentfile.pdf" - they appear at the bottom of the list
7. You must select AT LEAST ONE qualification against which this unit standard will be registered
8. Click "Submit"

When you need to update a few unit standard files at a time, then use the "Update/replace a unit standard's files" option.

Designed to work with a single file at a time, this option uploads the new file, updates the main database with the new file's name, updates the store's database in a similar fashion, and then makes sure the file being replaced is deleted.

As straightforward as this sounds (and is), there is one critical requirement that cannot be overlooked: the way in which the file is named.

1. It must follow the form of "U12345_Workbook_MonthYear.pdf" or "U12345_Assessment_MonthYear.pdf" (or .doc for the assessment files).
2. No blank spaces are permitted in the filename
3. The filename must contain either "Workbook" or "Assessment" (this requirement is case insensitive)
4. The first character of the filename must be (capital) "U"
5. An underscore character must exist between the unit standard number and the word "Assessment" or "Workbook"
6. The unit standard number (12345 in the example above) must not have leading zeros.  For example, you must have U497_Workbook_Nov2010.pdf, *NOT* U00497_Workbook_Nov2010.pdf
7. Finally, the unit standard must already exist in the database - this is NOT the option to use if you are wanting to add a NEW unit standard.

Look a the small square icon next to the title of the unit standards listed in the "Current" and "Completed" lists.  When you hover your mouse over it, you'll get a display that will specify the time and the file that was downloaded (see Fig below)

This probably means that your browser is Internet Explorer version 7.  The solution is to update your browser - the current version is 9, or do yourself a real favour and get a decent browser (Firefox, Chrome, Safari or Opera are all better than IE).

1. Filenames must not contain any spaces (remove them or substitute them with the underscore character: _ )
2. The width of the image you are uploading must be at least 200 pixels wide. All images exceeding this width will be automatically adjusted to 200 pixels
3. This adjustment creates a copy of the original image. You can tell the new copy by the "_t" that is added to its name (e.g. original: myprettypicture.jpg; processed copy: myprettypicture_t.jpg)

1. Only one "thing": filenames must not contain any spaces (remove them or substitute them with the underscore character: _ )

There are two ways:

1. If you have already uploaded the file, type in the first 3 characters of its name into the input box and the "auto-complete" feature of the wizard will suggest the rest of the file's name.
2. Enter the report's filename into the input box and then upload the file at a later time.

You need to select the files from a list.

1. Generate the list by clicking on the icon next to the "Associated downloadable file(s) label
2. Click on the filenames that are to be associated with this item
3. Click on the [Transfer] link at the top of the panel
4. The selected files will appear immediately below the "Associated downloadable file(s)" input box
5. That's it. Do NOT copy the filenames into the input box - this is not required.

This depends on whether you have the file list panel visible or whether you are editing an existing item.

If the file list panel is open:

1. Click [Uncheck]
2. Click [Transfer]
3. The list of filenames below the "Associated downloadable file(s)" input box will disappear.
4. Select the files you want (if any)
5. Click on the "Save as the newest version" button to save the updated information

If you are editing an existing item:

1. Click the [clear these files] link that appears following the list of files below the "Associated downloadable file(s)" input box.
2. Select the files you want (if any)
3. Click on the "Save as the newest version" button to save the updated information

This category acts as a holding category.  If you choose to delete a category that is associated with items in the database, those items will be automatically "transferred" to the sandbox category.

This category acts as a holding category for audiences. 

If you choose to delete an audience category that is associated with items in the database, those items will be automatically "transferred" to the orphan category. 

In addition to keeping these items "safe", it also acts to turn the items offline, as items in the "orpan" audience category are not displayed to users.