NAME

Rubric::Config - the configuration data for a Rubric

VERSION

 $Id: Config.pm,v 1.20 2005/04/15 13:26:14 rjbs Exp $

DESCRIPTION

Rubric::Config provides access to the configuration data for a Rubric. The basic implementation stores its configuration in YAML in a text file found using Config::Auto's find_file function. By default, Rubric::Config looks for rubric.yml, but an alternate filename may be passed when using the module:

 use Rubric::Config ".rubric_yml";

SETTINGS

These configuration settings can all be retrieved by methods of the same name.

• dsn

  the DSN to be used by Rubric::DBI to connect to the Rubric's database

• db_user

  the username to be used by Rubric::DBI to connect to the Rubric's database

• db_pass

  the password to be used by Rubric::DBI to connect to the Rubric's database

• uri_root

  the absolute URI for the root of the Rubric::WebApp install

• css_href

  the absolute URI for the stylesheet to be used by Rubric::WebApp pages

• template_path

  the INCLUDE_PATH passed to Template when creating the template renderers

• email_from

  the email address from which Rubric will send email

• smtp_server

  the SMTP server used to send email

• entries_query_class

  This is the class used to process the entries run method. It defaults to Rubric::WebApp::Entries.

• login_class

  This is the class used to check for logins; it should subclass Rubric::WebApp::Login. If not supplied, the default is Rubric::WebApp::Login::Post.

• skip_newuser_verification

  If true, users will be created without verification codes, and won't get verification emails.

• registration_closed

  true if registration new users can't register for accounts via the web

• private_system

  true value if users must have an account to view entries

• one_entry_per_link

  if true, each user can have only one entry per link (default: true)

• allowed_schemes

  If undef, all URI schemes are allowed in entries. If it's an array reference, it's the list of allowed schemes.

• default_page_size

  The number of entries that are displayed on a page of entries, by default.

• max_page_size

  The maximum number of entries that will be displayed on a page of entries. If more are requested, this many will be displayed.

METHODS

These methods are used by the setting accessors, internally:

_read_config

This method returns the config data, if loaded. If it hasn't already been loaded, it finds and parses the configuration file, then returns the data.

_default

This method returns the default configuration has a hashref.

make_ro_accessor

Rubric::Config isa Class::Accessor, and uses this sub to build its setting accessors. For a given field, it returns the value of that field in the configuration, if it exists. Otherwise, it returns the default for that field.

AUTHOR

Ricardo SIGNES, <rjbs@cpan.org>

BUGS

Please report any bugs or feature requests to bug-rubric@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

COPYRIGHT

Copyright 2004 Ricardo SIGNES. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.