NAME

ePortal::Application - The base class for ePortal applications.

SYNOPSIS

An application is registered with ePortal via parameter

 application ePortal::App:ApplicationName

To create an application derive it from ePortal::Application and register in ePortal.conf.

INITIALIZATION

During Apache's startup phase an application object will be created and initialized.

  new()
  initialize_config() (overwrite it)
    read [common:ApplicationName] (by ePortal::Application)
    read [vhost:ApplicationName] (by ePortal::Application)
  initialize() (overwrite it)
    create DBISource if needed (by ePortal::Application)
    create sysacl if needed
    create user groups if needed
  ?????
  register PageView sections
  register cron events
  register database upgrade script

DATABASE ACCESS

ePortal::Application registers in initialize_config() three parameters for you: dbi_source, dbi_user, dbi_password. During initialize() a DBISource object will be create with a name of ApplicationName().

Use this new DBISource as the follows:

 my $obj = new ePortal::ThePersistent::Support("SQL", undef, "ApplicationName");
 my $obj = new ePortal::ThePersistent::Support($attributes, "table_name", "ApplicationName");
 # here ApplicationName is a name of DBISource object.

SECURITY

METHODS

ApplicationName

You should overwrite this method to supply your own application name. By default a last part of application's package name is used.

new($config)

Application constructor. Should be never overwrited. Use Initialize_xxx methods if you need an extra initialization.

initialize()

This is application initializer. By default initialize() creates new DBISource if any of dbi_xxx parameters are meet in config file.

onDeleteUser,onDeleteGroup

This is callback function. Do not call it directly. It is called from ePortal::Server. Overload it in your application package to remove user or group specific data.

Parameters:

• username or groupname

  User or Group name to delete.