GenieGate has the ability to store and maintain arbitrary personal settings. Typical uses are postal addresses, zip codes, favorite colors and things like that.
Personal settings are used in GenieGate's vCard export implementation.
If you are not using personal settings, you may skip over this section.
Unlike other profile managers, you do not need to know in advance which settings are required. You may add them through the administration interface.
This section covers properties from the perspective of user access.
GenieGate distinguishes between internal and external properties. External properties may be changed by the user, while internal properties are reserved for the administrators use.
Furthermore, GenieGate allows multiple classifications of properties on an API level. This provides 3rd party applications and custom software with an ability to store properties unique for it's purposes separate from the main ones used by GenieGate.
About web/users/properties.php. There is a provided script that shows the HTML required to set properties, it primarily serves as an example of the required HTML, and should probably not be used in a production web site. (It shows ALL public properties on one page in no particular order)
There is another file in web/example/forms/properties.php that demonstrates a more uniform, orderly approach. The example enables a user to view and change their address. It needs to be edited before it can work. ($LIB and $POST_URL will need to be set to their proper locations)
Table 5-7. Form variables for changing properties
| Form Variable | What it does | |||
|---|---|---|---|---|
| DO_UPDATE_SETTINGS | Directive, tells index.php to update the personal settings. | |||
| LOCATION | Optional, redirected page after completion. | |||
| PROP:propId | The property ID to change. PROP:propId | |||
The PROP:propId may need further explanation; anything after the "PROP:" is interpreted to mean a property ID. So, to set the zip code, one would use <INPUT NAME="PROP:postalCode" ... >