Rubric::Config - the configuration data for a Rubric
$Id: Config.pm,v 1.22 2005/05/30 22:31:21 rjbs Exp $
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:
find_file
rubric.yml
use Rubric::Config ".rubric_yml";
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.
entries
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
private_tag
A tag which, if attached to an entry, makes it private. The default value is @private, and I strongly advise against changing it, since I may change the way these "system tags" work in the future.
@private
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.
display_localtime
If true, the local time (of the server) will be displayed for entry create/modify times. Otherwise, all times will be UTC. (This option is probably temporary, until per-user timezones are implemented.)
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.
These methods are used by the setting accessors, internally:
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.
This method returns the default configuration has a hashref.
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.
Ricardo SIGNES, <rjbs@cpan.org>
<rjbs@cpan.org>
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.
bug-rubric@rt.cpan.org
Copyright 2004 Ricardo SIGNES. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Rubric, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Rubric
CPAN shell
perl -MCPAN -e shell install Rubric
For more information on module installation, please visit the detailed CPAN module installation guide.