Modifying Horde Aspect

Written by: Ciro Durán <ciro -dot- duran -at- gmail -dot- com>

---

Document status

This document (in the traditional Wikipedia style) is a stub. You can help Horde Wiki by expanding it.

• 2005-Jan-31 - The document was started. A very rudimentary structure has been laid.

Introduction

This tutorial is intended to give designers a first insight on how to modify the default Horde 3 layout. We are not talking here about creating a new theme for the default layout (you can consult more about that in the ThemesHowTo page), but to alter completely the layout (frames included). At the current version of Horde, this requires a substantial amount of work, as you need to mess with a good deal of HTML and CSS files.

Motivation

Let's start saying that you don't have any trouble with the default layout. It's well done, has nice bright colors, and is very attractive in general, and it's surprising that despite the ease of use the Horde Framework and Horde Applications have achieved, you have to learn a lot of stuff about the Horde Framework just to start mangling with the .inc files in the /templates directory. And when you want to deliver the power Horde has for, say, a client, you need the layout to be customizable, as they want to establish the graphic style their new portal will have.

In this tutorial we have saved that amount of work for you, and if you want to learn more about the functions the default layout uses, we have provided links to the API in http://dev.horde.org, thus you can consult the links in the References section, in the end of this document.

Prerrequisites

If you are a web designer, you should know a good deal of HTML, Javascript, CSS, and PHP. This tutorial assumes you know all this, thus the HTML, CSS and Javascript conflicts between Mozilla and Internet Explorer. About Horde Framework knowledge, we will assume you don't know its internals, so we will give as well a short insight of the process Horde follows in order to deliver the applications the user needs.

What is Horde?

Horde is... (This should explain what the Framework is, and make a difference between the Horde Framework and Horde Applications).

Getting started

(An introduction to this section. This section explains some standard procedures Horde follows to do common tasks)

What does Horde do when someone enters it?

How does Horde authenticate?

How does Horde keep sessions? What values does it keep?

What are templates? What's the difference with themes?

How does Horde standarize its interface?

The Menu class

The Menu class allows you to render the current application utilities' links in an HTML unordered list, allowing you to set the style of it using CSS. The default Horde layout uses the menu ID to fix the menu on the top right corner of its templates.

If you wish to customize the menu, you need to create a Menu class. The constructor function accepts one parameter, called $mask, which is useful to add common links in the menu, like a Help link, or a Problems link.

In the image above, you can see the icons that can be masked by the Menu class. Number 1 corresponds to HORDE_MENU_MASK_PROBLEM'.

An introductory example: The login screen

References

• Hagenbuch, Chuck, Horde Framework Tutorial, http://www.horde.org/papers/oscon2001-horde_tutorial/
  • Hagenbuch, Chuck, Developing with Horde Framework, http://www.horde.org/papers/kongress2001-horde_tutorial/