[ The Website@School logo is a registered trademark of Vereniging Website At School ]

Website@School Users' Guide

Searchable table of contents of all chapters

Table of contents [ Updated 2016-07-07 ]

Abstract [ Updated 2014-08-18 ]

Preface [ Updated 2014-09-06 ]

1. Why a users guide?
2. Acknowledgments
3. Who should not use Website@School?

Introduction [ Updated 2014-09-05 ]

1. Introduction
    1.1 The rock-bottom assumptions
        1.1.1 Main design viewpoints
        1.1.2 What students can learn
        1.1.3 User requirements
    1.2 The Website@School teams
        1.2.1 Core team
        1.2.2 Translators
        1.2.3 Code contributors
        1.2.4 Graphics
        1.2.5 Donors
        1.2.6 Testers
        1.2.7 Others

2. Features
    2.1 Civil liberties features
    2.2 Security features
    2.3 Features for blind and visually impaired
    2.4 Usability features

3. Available modules and themes

4. Supported languages
    4.1 Website@School program
    4.2 Website@SChool Users' Guide

5. Wish list

6. Useful links
    6.1 Downloads
    6.2 Etc

7. References

8. History

9. To conclude

Basic procedures for beginners [ Updated 2014-09-13 ]

1. Introduction
    1.1 What you need to know first
    1.2 Access: username and password
    1.3 Documentation conventions

2. Preparations
    2.1 Two browser windows
        2.1.1 First browser: website
        2.1.2 Second browser: management
    2.2 Logging in
    2.3 Management home page
        2.3.1 General features
        2.3.2 Blind and visually impaired Users
        2.3.3 [Save], [Done] and [Cancel]
    2.4 The Welcome page explained
    2.5 Logging out

3. Areas, Sections, pages, text and images
    3.1 Add an Area
    3.2 Add a page
        3.2.1 Page and section icons
    3.3 Add some text
    3.4 Add an image
        3.4.1 Select the right folder
        3.4.2 Upload an image
        3.4.3 Insert the image into the web page
    3.5 Add a section
    3.6 Create some order

4. Access permissions
    4.1 Administrator permissions
    4.2 Page manager permissions

5. Add a User

6. Groups and capacities

7. Miscellaneous
    7.1 Locked page
    7.2 Our sandbox
    7.3 Get rid of the Exemplum Primary School

8. How to continue?

Logging in and out [ Updated 2014-06-29 ]

1. Introduction
    1.1 Features
    1.2 Assumptions
    1.3 Password requirements

2. Logging in and out
    2.1 Logging in
    2.2 Logging out

3. Forgotten your password?

4. Error messages
    4.1 Incorrect User name or password
    4.2 Too many login attempts
    4.3 Auto logout
    4.4 Access denied
    4.5 One-time code error

5. Tips
    5.1 A link from public- to a private Area
    5.2 Do not change a password!

6. Concluding remarks

Installation [ Updated 2016-06-23 ]

1. Introduction
    1.1 Conventions
        1.1 1 General
        1.1.2 Documentation conventions
        1.1.3 web servers and folders
    1.2 Requirements
        1.2.1 Technical requirements
        1.2.2 User requirements
    1.3 Preparations
        1.3.1 Downloads
        1.3.2 Installing on a server with root (administrator) access
        1.3.3 Installing on a server without root access
        1.3.4 Installing on a XS4ALL server
        1.3.5 Installing on a PC with XAMPP
    1.4 On secure passwords

2. The installation
    2.1 Language
    2.2 Installation type
    2.3 License
    2.4 Database
    2.5 Website
    2.6 User account
    2.7 Compatibility
    2.8 Confirmation
       2.8.1 Crossroads
    2.9 Finish
    2.10 Download configuration file
    2.11 E-mail alerts

3. Tips for a secure installation
    3.1 Program files and configuration file
    3.2 Data files
        3.2.1 Outside the document root
        3.2.2 Inside the document root

4. After the installation
    4.1 Virus scanning
    4.2 Session name
    4.3 Proxy friendly URLs
    4.4 Configuring cron.php

5. Errors
    5.1 Canceled installation
    5.2 Unable to write in data directory
    5.3 Config.php write problems

6. Upgrading

7. Concluding remarks

Page manager [ Updated 2014-05-17 ]

1. Introduction
    1.1 Features
    1.2 Assumptions

2. Page Manager overview
    2.1 Clickable links and icons

3. Pages
    3.1 Add a page
    3.2 Basic properties: Edit basic properties of page nn
    3.3 Advanced: Edit advanced properties of page nn
    3.4 Content
    3.5 Delete a page

4. Sections
    4.1 Add a section
    4.2 Basic properties: Edit basic properties of section nn
    4.3 Advanced: Edit advanced properties of section nn
    4.4 Delete a section

5. Moving areas, sections and pages

6. Locked pages
    6.1 Unlocking via Session Manager

7. To conclude

File manager [ Updated 2014-07-13 ]

1. Introduction
    1.1 Features
    1.2 Assumptions

2. File Manager overview

3. Managing files
    3.1 Add (upload) files
    3.2 Create subfolders

4. Delete files and folders

5. Using files: file paths

6. VIRUS!

7. Known issues

8. Concluding remarks

Module manager [ Updated 2014-06-15 ]

1. Introduction
    1.1 Features
    1.2 Assumptions

2. Module Manager overview

3. Concluding remarks

Account manager [ Updated 2016-07-06 ]

1. Introduction
    1.1 Features
        1.1.1 For Blind and Visually Impaired Users
    1.2 Assumptions
    1.3 The Exemplum Primary School example

2. Account manager overview
    2.1 Users: introduction
    2.2 Groups: introduction

3. Users
    3.1 Add a new User
    3.2 Edit: User properties, access permissions, Group/Capacity memberships
        3.2.1 Basic: Edit User username (Full Name)
        3.2.2 Groups/Capacities
            3.2.2.1 Add a User to a Group/Capacity
            3.2.2.2 Remove a User from a Group/Capacity
            3.2.2.3 Change a User's Capacity in a Group
        3.2.3 Intranet
        3.2.4 Administrator permissions: username (Full Name)
        3.2.5 Page Manager
            3.2.5.1 Table: Roles and permissions
            3.2.5.1 Edit User username (Full Name)
    3.3 Delete a User account

4. Groups and Capacities
    4.1 Add a new Group
    4.2 Edit: Group properties, Capacities, add Users to Capacities
        4.2.1 Basic properties
        4.2.2 Capacities 1-8
    4.3 Add a User to a Group/Capacity
    4.4 Delete a Group

5. Skins
    5.1 Base Skin
    5.2 Big Skin
    5.3 Braille Skin
    5.4 Low vision Skin
    5.5 Text Only Skin

6. Concluding remarks

Configuration manager [ Updated 2016-06-23 ]

1. Introduction
    1.1 Features
        1.1.1 Areas features
        1.1.2 Site features
        1.1.3 Alerts features
    1.2 Assumptions

2. Configuration Manager overview

3. Areas
    3.1 Areas overview
    3.2 Add an area
    3.3 Edit basic properties of this area
    3.4 Configure theme 'Theme name' for area n
    3.5 Reset properties of theme themename for area n (Area Name)
    3.6 Delete an area

4. Site
    4.1 Site configuration

5. Alerts
    5.1 Alerts overview
    5.2 Add an alert
    5.3 Edit an alert
    5.4 Delete an alert
    5.5 Alert tips

6. Concluding remarks

Statistics [ Update 2016-07-07 ]

1. Introduction

2. Statistics
    2.1 All areas
    2.2 Single area

3. Concluding remarks

Tools [ Updated 2016-07-07 ]

1. Introduction
    1.1 Features
    1.2 Assumptions

2. Tools manager overview

3. Translate tool
    3.1 Translate Tool overview
    3.2 Add a new language
    3.3 Translate a language
    3.4 Edit language properties
    3.5 Small language adaptions
       3.5.1 High visibility adaptions
       3.5.2 Export changes

4. Backup tool
    4.1 Database backup
    4.2 Data backup

5. Log viewer
    5.1 Download log
    5.2 Prune log

6. Update Manager
    6.1 Core update
    6.2 Other updates

7. Session Tool

8. Concluding remarks

Editors [ Updated 2014-11-07 ]

1. Introduction

2. WYSIWYG editors
    2.1 English manuals
        2.1.1 CKEditor
        2.1.2 FCKEditor
    2.2 Spanish manual
    2.3 Dutch manual

3. Plain HTML editor

4. Collaborative editor

Aggregator [ Updated 2013-03-20 ]

1. Introduction
    1.1 Description of the module

2. Adding the module

3. Configuration optionns
    3.1 Content options
    3.2 Advanced options

4. The module in practice: tips
    4.1 Header and introduction
    4.2 List of pages and sections
    4.3 Number of pages to aggregate
    4.4 Reverse the sort order
    4.5 Width -, height - and visible images (snapshots
    4.6 Playing wiht BSS

Album [ Waiting for donations ]

Althing (weblog) [ Last updated 2014-06-25 ]

1. Introduction
    1.1 Assumptions
    1.2 Features

2. Alting demonstration web page
    2.1 Althing for the impatients
    2.2 Posting
        2.2.1 Add a post
        2.2.2 Preview post (#0)
        2.2.3 Post post (#1)
    2.3 Replying (#2)
    2.4 Adding files (#3 & #8)
    2.5 Harvesting (#11)
    2.6 More posts, more to see
        2.6.1 Almost everything (post #5)
        2.6.2 Quoting (post #6)
        2.6.3 Postillion d'amour (post #7
        2.6.4 Post a link (post #9
        2.6.5 Redacted (post #10
        2.6.6 Harvesting (post #11
        2.6.7 Unpublished (Post #12)
        2.6.8 The bottom line

3. Content options
    3.1 Content
    3.2 Configure
        3.2.1 Status and visibility
        3.2.2 The e-mail alert messages
        3.2.3 Text fields
    3.3 Moderate
        3.3.1 Moderate overview
        3.3.2 Moderate a post
    3.4 View log
    3.5 Report
    3.6 Advanced options

4. The module in practice: tips
    4.1 Althing management permissions
    4.2 Those awful colors
    4.3 Entry fields in Add a post
    4.4 References

Confab (Chat) [ Last updated 2014-11-19 ]

1. Introduction
    1.1 Assumptions
    1.2 Features

2. Confab demonstration web page
    2.1 Confab for the impatients
    2.2 Entering the Confab
    2.3 The braille interface
        2.3.1 Read
        2.3.2 Anticipate
        2.3.3 Write
    2.4 The visual interfaces
        2.4.1 visual
        2.4.2 visual (LowVision)
        2.4.3 visual (Red Blue Gray)
        2.4.4 visual (Mondrian)

3. Content options
    3.1 Configure
    3.2 Moderate
    3.3 Report

4. Advanced options

5. The module in practice: tips
    5.1 No speaker icon

HTML Page

1. Introduction
    1.1 Description of the module

2. Adding the module

3. Configuration optionsns
    3.1 Content options
    3.2 Advanced options

Mailpage [ Updated 2013-08-20 ]

1. Introduction
    1.1 Features
    1.2 Description of the module

2. Adding the module

3. Configuration options
    3.1 Content
        3.1.1 Configure: Mailpage configuration
        3.1.2 Destination: Mailpage destinations overview
            3.1.2.1 Destination: Add new destination address
            3.1.2.2 Destination: Edit destination address
    3.2 Advanced options

4. The module in practice: tips
    4.1 Error: no destination address for page nn
    4.2 Change texts in the Translate Tool
    4.3 Sort order

5. CAPTCHAs and visually impaired

6. Concluding remarks

My Page [ Updated 2016-06-20 ]

1. Introduction
    1.1 Features

2. My Page overview
    2.1 My Page for visitors
    2.2 My Page for webmasters
    2.3 My Page for regular users

3. Edit profile

4. Change password

5. Adding and configuring the module
    5.1 Content options
    5.2 Advanced options

6. The module in practice: tips

Newsletter [ Updated 2015-06-17 ]

1. Introduction
    1.1 Assumptions
    1.2 Features

2. Newsletter demonstration web page
    2.1 Newsletters for the impatient
    2.2 Reading the latest issue
    2.3 Archive of newsletter issues
    2.4 Subscribing to the newsletter
        2.4.1 Validation and approval
        2.4.2 Validation only
    2.5 Unsubscribing from the newsletter
    2.6 Receiving newsletters by e-mail
        2.6.1 Announcement
        2.6.2 Announcement with teasers
        2.6.3 Full newsletter
    2.7 Contributing

3. Content options
    3.1 Configure
        3.1.1 Name, subtitle and channel
        3.1.2 E-mail parameters
        3.1.3 Templates for newsletter layout
        3.1.4 Contribution policy
        3.1.5 Subscription policy
        3.1.6 Web page configuration
        3.1.7 Newsletter administration
    3.2 Compose
        3.2.1 Adding an article
        3.2.2 Editing an article
        3.2.3 Deleting an article
        3.2.4 Postponing an article
        3.2.5 Selecting an article
        3.2.6 Changing the article order
        3.2.7 Previewing the new issue online
        3.2.8 Sending a preview by e-mail
    3.3 Publish
        3.3.1 Final preview online
        3.3.2 Final preview by e-mail
        3.3.3 Publishing the new newsletter issue
    3.4 Subscribers
        3.4.1 Adding a subscriber
        3.4.2 Editing a subscriber
        3.4.3 Deleting a subscriber
        3.4.4 Approving a subscription request
        3.4.5 Blacklisting an e-mail address
        3.4.6 Downloading subscriber data
        3.4.7 Uploading subscriber data
    3.5 Queue

4. Advanced options
    4.1 Access control
        4.1.1 Newsletter Editor
        4.1.2 Newsletter Publisher
    4.2 Using teasers ('Ankeilers')

5. The module in practice: tips
    5.1 Deep-links to newsletter articles
        5.1.1 Newsletter URLs
        5.1.2 Articles within a newsletter
    5.2 CSS in newsletter vs. BSSS on webpage
    5.3 Overview of available CSS selectors
    5.4 Overview of available template variables

Redirect [ Updated 2013-07-05 ]

1. Introduction
    1.1 Description of the module

2. Adding the module

3. Configuration options
    3.1 Content options
    3.2 Advanced options

4. The module in practice: tips

Search [ Updated 2016-07-06 ]

1. Introduction
    1.1 Features

2. Search overview
    2.1 Search current area
    2.2 Search all available areas
    2.3 Search public areas only

3. Adding the module

4. Configuration options
    4.1 Content options
    4.2 Advanced options
    4.3 Overview of available CSS selectors

5. The module in practice: tips

Sitemap [ Updated 2012-06-04 ]

1. Introduction
    1.1 Features
    1.1 Description of the module

2. Adding the module

3. Configuration options
    3.1 Content options
    3.2 Advanced options

4. The module in practice: tips

Snapshots [ Updated 2013-06-25 ]

1. Introduction
    1.1 Description of the module

2. Adding the module

3. Configuration options
    3.1 Content options
    3.2 Advanced options

4. The module in practice: tips
    4.1 Resize images before uploading
    4.2 Create picture folder before adding Snapshot page
    4.3 Slideshow tricks
    4.4 Using the thumbnails
    4.5 Box sizes of themes
    4.6 Linking to the Snapshots module
    4.7 Slideshow not working
    4.8 Cannot upload files!
    4.9 Automatic full screen browser
    4.10 Interactive slideshow

TV Show [ Waiting for donations ]

Workshop (CREW) [ Updated 2014-11-18 ]

1. Introduction
    1.1 Assumptions
    1.2 NOTICE!
    1.3 Features and limitations
    1.4 Backgrounds

2. CREW for pupils and teachers
    2.1 Add a CREW page
        2.1.1 Header and Introduction
        2.1.2 Visibility: World or Authenticated
        2.1.3 Visibility: Individuals
    2.2 Who sees what?
    2.3 Enter CREW
    2.4 "It does'nt work!"
    2.5 Advanced options

3. CREW for the webmaster
    3.1 Configure CREW
    3.2 Check your work

4. CREW for the systems administrator
    4.1 Which server and port?
    4.2 Firewalls
    4.3 Server installation
        4.3.1 The readme.txt
        4.3.2 The crewserver-example.conf text
        4.3.3 Init script
        4.3.4 /var/log/messages
        4.3.5 Help!
    4.4 "After x I got y"

Theme Axis [ Updated 2014-07-21 ]

1. Introduction
   1.1 Screenshots of theme Axis
   1.2 Description of theme Axis

2. The theme configuration
   2.1 Basic properties
   2.2 Theme configuration
   2.3 Reset theme

3. The theme in practice: tips
   3.1 New background image and location
   3.2 Different backgrounds for sections and pages
   3.3 How to change the position of the menu
   3.4 Printer friendly style sheet

Theme Cornelia [ Updated 2014-07-21 ]

1. Introduction
   1.1 Screenshots of theme Cornelia
   1.2 Description of theme Cornelia

2. The theme configuration
   2.1 Basic properties
   2.2 Theme configuration
   2.3 Reset theme

3. The theme in practice: tips
   3.1 Additional stylesheet for 2-columns
   3.2 Printer friendly stylesheet
   3.3 Banners and rotation
   3.4 Additional HTML
   3.5 Comma-delimited list of pages to display in sidebar
   3.6 Change transparency
   3.7 Colored sidebars (under construction)

Theme Frugal [ Updated 2014-07-21 ]

1. Introduction
   1.1 Screenshots of theme Frugal
   1.2 Description of theme Frugal
      1.2.1 Theme Frugal on a regular screen
      1.2.2 Theme Frugal on a small screen
      1.2.3 Theme Frugal on a wide screen

2. The theme configuration
   2.1 Basic properties
   2.2 Theme configuration
   2.3 Reset theme

3. The theme in practice: tips
   3.1 For visually impaired
      3.1.1 Styling: labels, input fields and buttons
      3.1.2 Styling: input field details
      3.1.3 Styling: buttons details
   3.2 Replace the Website@Schoool logo
   3.3 Adapting the footer

Theme Rosalina [ Updated 2013-07-21 ]

1. Introduction
   1.1 Screenshot of theme Rosalina
   1.2 Description of theme Rosalina

2. The theme configuration
   2.1 Basic properties
   2.2 Theme configuration
   2.3 Reset theme

3. The theme in practice: tips
   3.1 Hotspots
   3.2 Image maps

Theme Ruta [ Updated 2016-07-05 ]

1. Introduction
    1.1 Screenshots of theme Ruta
        1.1.1 Regular screen
        1.1.2 Regular screen with 2-columns
        1.1.3 Medium screen
        1.1.4 Small screen
        1.1.5 Wide screen
        1.1.6 Example
    1.2 Description of theme Ruta
        1.2.1 Extended description (regular screen)
        1.2.2 Changes on a medium-sized screen
        1.2.3 Changes on a small screen
        1.2.4 Changes on a wide screen

2. The theme configuration
    2.1 Basic properties
    2.2 Theme configuration
    2.3 Reset theme

3. The theme in practice: tips
    3.1 Banners and rotation
    3.2 Comma-delimited list of pages to display in sidebar
    3.3 Additional stylesheet for 2-columns
    3.4 Additional HTML
    3.5 Change transparency

Theme Schoolyard [ Updated 2013-07-21 ]

1. Introduction
   1.1 Screenshot of theme Schoolyard
   1.2 Description of theme Schoolyard

2. The theme configuration
   2.1 Basic properties
   2.2 Theme configuration
   2.3 Reset theme

Theme Sophia [ Updated 2013-07-21 ]

Under construction!! 1. Introduction
   1.1 Screenshot of theme Sophia
   1.2 Description of theme Sophia

2. The theme configuration
   2.1 Basic properties
   2.2 Theme configuration
   2.3 Reset theme

3. The theme in practice: tips
   3.1 Changing background colors
   3.2 Creating stencil files
   3.3 Different stencils
   3.4 The path to your own stencil files

CHANGES.txt [ Updated 2016-06-22 ]

CHANGES.txt (unformatted text; opens in new window)

Tips and tricks [ Always under construction ]

(always under construction and sometimes a bit messy)

1. Introduction

2. Editing Bazaar Style Style Sheets
    2.1 Override an element
    2.2 Page Manager: vertical lines
    2.3 Schoolyard

3. Maintenance page

4. Useful tools

5. Blank screen

6. Concluding remarks

XAMPP installation [ Updated 2014-07-23 ]

1. Introduction

2. Problems

3. Linux, Mac, Windows
    3.1 Linux
    3.2 Mac (not ready)
    3.3 Windows (not ready)
        3.3.1 Known issues

4. To conclude

XS4ALL installation [ Updated 2013-12-23 ]

1. Introduction
    1.1 To Dutch readers
    1.2 Preparations

2. Activating the database

3. Preparations revisited

4. Downloading files

5. Uploading, unpacking, data directory
    5.1 Uploading files
    5.2 Unpacking files
    5.3 Creating the data directory

6. Installing Website@School on XS4ALL

7. Concluding remarks

Translate Website@School Program [ Updated 2014-05-09 ]

1. Introduction

2. Requirements

3. Log in on the translators website

4. To the Translate Tool
    4.1 Translate Tool overview
    4.2 Translate a language
        4.2.1 What about those ~'s (tildes)
        4.2.2 Tips for translators
    4.3 Update a language

5. Thank you!

Viewpoints [ Updated 2013-11-12 ]

(always under construction, somtimes a bit messy and apologies for the typos)

1. Introduction

2. On pedagogic views
    2.1 Protective pedagogies
    2.2 Esthetical pedagogies
    2.3 Society critical pedagogies
    2.4 Functional pedagogies

3 Where stands WebWebsite@School?
    3.1 A practical example

4. On form and content
    4.1 Cascading Style Sheets
    4.2 Bazaar Style Style

5. On websites for primary education
    5.1 What is a primary school and what it's not
    5.2 Design philosophy
    5.3 Theory in practice

6. On educational software

7. Links we like

8. Concluding remarks

Bazaar Style Style [ Under construction ]

Under construction. May contain errors!

1. Introduction
    1.1 Assumptions
    1.2 A bit of history
        1.2.1 Summary
    1.3 The basics basics
        1.3.1 A quick and practical example
    1.4 Where to put style?

2. Replace the Website@School logo

3. A new header for the school
    3.1 The picture
    3.2 Resize the picture
    3.3 Crop the picture
    3.4 Upload the picture
    3.5 Use BSS to get the picture in the header

4. Where to put your style in Website@School?
    4.1 At Area level
    4.2 At Section and Page level

5. More CSS

Authors: Dirk Schouten <dirk at websiteatschool dot eu> and Peter Fokker <peter (at) websiteatschool (dot) eu>
Last updated: 2016-07-07