=head1 NAME

Bric::Changes - Bricolage Changes

=head1 DATE

$LastChangedDate: 2006-06-22 16:45:48 -0700 (Thu, 22 Jun 2006) $

=head1 DESCRIPTION

This document lists the Changes to Bricolage introduced with each release.

=head1 VERSION 1.10.2 "Summer" (2006-06-22)

=head2 Improvements

=over

=item *

Added the C<subelement_id> parameter to the story and media C<list()> methods.
[David]

=item *

Added placeholder for Japanese localization. Expect a translation soon!
[David]

=item *

The "codeselect" field's Perl code can now return an array of array references
or a hash reference, in addition to the previous support for an even-sized
array reference. [David]

=item *

Added a "Republish" checkbox and corresponding "Publish Checked" button to the
Story and Media "Find" pages for stories and media not currently in workflow
and to which the user has PUBLISH permission. Based on a patch from Serge
Sozonoff. [David]

=item *

Added tests for L<Bric::SOAP::Auth|Bric::SOAP::Auth>, although they haven't
yet been integrated into C<make devtest>. [Scott]

=item *

The number of items on a desk can now be displayed next to the desk's name in
the navigation menu, e.g. "Edit (10)". This feature is configurable on a
per-user basis via the new "Show Desk Asset Counts" preference. Based heavily
on a patch from Alex Howarth. [Marshall]

=item *

Updated F<README.MacOSX> with instructions on how to use the built-in version
of Apache instead of compiling everything yourself. Also fixed a broken link
and an outdated warning about L<Apache::SizeLimit|Apache::SizeLimit>.
[Marshall]

=item *

Internationalized the JavaScript messages for the Find/Replace dialog box,
although there are currently no translations. [David]

=item *

Added a close icon to the drag bar of the dialog box. This is useful when the
dialog box is bigger than the browser window and the close button therefore is
off-screen. [David]

=item *

Optimized the C<get_notes()> and C<has_notes()> methods of
L<Bric::Biz::Asset|Bric::Biz::Asset> and therefore of the story, media, and
template classes. [David]

=item *

Aliases are now indicated in Find Stories by an arrow icon just before the
story title. Suggested by Paul Orrock. [David]

=item *

Added C<PUBLISH_RELATED_FAIL_BEHAVIOR> F<bricolage.conf> directive to be used
when C<PUBLISH_RELATED_ASSETS> is enabled. If the automatic publication of a
related story or media document will not be possible then the publish request
will fail. It can be changed to "warn", the previous behaviour, if required.
[Paul Orrock]

=item *

Added the "Remove Frameset" link to the control bar next to the "Repreview"
link in the preview window. [Paul Orrock]

=item *

Deleted all of the outdated and unused F<.use> files from F<sql/Pg>. [David]

=item *

Removed documentation of the C<-t> option of F<bric_pgimport>, which hasn't
actually done anything for a long time, anyway. [David]

=item *

Moved translation-specific JavaScript and CSS files into F<i18n> folders under
their respective folders in F<comp/media/>. [Marshall]

=item *

Slightly tweaked the background color on table rows to make them easier to
read. [Marshall]

=item *

Converted the group permissions editor to XHTML and CSS to fix some rendering
glitches. [Marshall]

=item *

Made word and character counts properly appear read-only, and repositioned the
find/replace and cheat sheet buttons to the top right of the box. [Marshall]

=item *

Object select lists (such as for story element types when creating a new
story) will now display as scrolling lists if there are more than 50 items in
the list, rather than 20 or more items. [David]

=item *

Added a CSS ID to the C<< <body> >> tag in the UI, of the form
"bricolage_C<VHOST_SERVER_NAME>", where C<VHOST_SERVER_NAME> is the value
defined in F<bricolage.conf>.  Use this ID when writing user stylesheets 
to override the look of the Bricolage UI (see SkinningBricolage in the Wiki)
[Marshall]

=back

=head2 Bug Fixes

=over

=item *

Fixed the rarely-used C<DISABLE_NAV_LAYER> F<bricolage.conf> directive.
[Scott]

=item *

Fixed warnings in deprecated methods of
L<Bric::Biz::Element::Container|Bric::Biz::Element::Container> so that they
are no longer fatal. Reported by Nate Perry-Thistle. [David]

=item *

Fixed reverted media that led to the "Too many Bric::Biz::Element::Container
objects found" error. It was supposed to have been fixed in 1.10.1, but that
fix unfortunately only fixed stories. Reported by Tom Kjeldsen. [David]

=item *

Fixed the C<subelement_key_name> parameter to the story and media C<list()>
methods. [David]

=item *

Fixed the "Search by Subelement" feature of story search. Thanks to Nate
Perry-Thistle for the spot. [David]

=item *

Fixed highlighting when sorting by Element on desks (bug 1185). [Brad Harder]

=item *

The "Default Field" select list in Bulk Edit works again. Thanks to Tom
Kjeldsen for uncovering the underlying problem. [David]

=item *

The C<throw_error()> method in L<Bric::Util::Burner|Bric::Util::Burner> works
properly again. Thank to Paul Orrock for the spot and to Scott for revealing
the solution. [David]

=item *

The "Story Type" and "Media Type" options for sorting stories and media,
respectively, on desks and on My Workspace, work again. Reported by Brad
Harder. [David]

=item *

The F<inst/upgrade/1.9.1/xtract_attype2.pl> upgrade script now detects whether
the database has been converted to use boolean columns and casts values moved
from numeric columns accordingly. Reported by Brad Harder. [David]

=item *

Fields that use the "codeselect" widget work again. Reported by Michael
Glaesemann. [David]

=item *

Fixed auto-publishing related media and stories so that relateds of relateds
now correctly pull out all the items to be published, e.g., media related to
story related to published story (bug 1190). [Paul Orrock]

=item *

Updated F<inst/upgrade/1.9.0/no_more_numeric.pl> so that it properly handles
cases where PostgreSQL's dump does not use parentheses for casts. Reported by
George Harrison. [David]

=item *

Aliases no longer show up in the search results of the "New Alias" screen,
since aliases can't be aliased. The "New Alias" screen now also shows the site
a document belongs to if there are multiple sites. [Marshall]

=item *

Fixed the appearance of template diffs. Insertions and deletions now have
color and no longer show underlines and strikethroughs (bug 1171). [Marshall]

=item *

Character counts in Bulk Edit are now properly updated after using
Find/Replace. [Marshall]

=item *

Pulldowns no longer improperly display as 32-items tall in the story/media
profiles (bug 1178, reported by Alex Howarth). [Scott and Marshall]

=item *

Fixed a bug where search results would get "stuck" when pagination is turned
on. Thanks to Nate Perry-Thistle for the spot (bug 1166). [Marshall]

=item *

Fixed a warning from F<bric_republish> when run without a password. Thanks to
John Gillis for the spot (bug 1188). [Marshall]

=item *

Fixed the "Site" dropdown in searches to only require READ permissions
rather than EDIT. Spot and quasi-patch by Chris Sutton. [Marshall]

=item *

New fields now are properly configured with the their C<multiple> attribute
copied from the field type. [Alexey Sheynuk]

=item *

New destinations can now be created via
L<Bric::Soap::Destination|Bric::Soap::Destination>. [Christian Niles]

=item *

Fields in an element that are based on field types deleted from the element
type can now still be edited in Bulk Edit. Thanks to Nate Perry-Thistle for
the spot. [David]

=item *

New users can once again be created when using the LDAP authentication engine.
Reported by Christian Niles. [David]

=item *

Using Internet Explorer to create a media document via a the upload field in a
related media element no longer uses a full Windows file system path. Reported
by Tom Kjeldsen. [David]

=item *

Fixed caching issue with reversion of assets to earlier versions. [David]

=item *

The category SOAP interface now allows the C<< <path> >> XML element to not
have a trailing slash, as was the case in Bricolage 1.8 and earlier. [David]

=item *

Aliases are once again identifiable on desks by a different background color
for the title, and now also with an arrow icon that appears just before the
story title. [David]

=item *

A field deleted from the contributor profile no longer continues to appear in
the profile when pressing the "Save and Stay" button. Reported by Marshall.
[David]

=item *

Eliminated an endless loop in prompting for the PostgreSQL user during
installation when the C<INSTALL_VERBOSITY> is set to "QUIET". [Rod Taylor]

=item *

Contributors are no longer sorted by the "Name Format" preference's
representation of the contributors' names in the interface to edit contributor
associations. They are now properly sorted by association order. Reported by
Bret Dawson. [David]

=item *

Documents without cover dates (mainly created via the SOAP interface) will no
longer have broken URIs. Reported by Christian Niles. [David]

=item *

The Help and logo popup buttons works again in Internet Explorer. Reported by
Chris Heiland. [David]

=item *

Autosizing textarea fields now display full size in Internet Explorer when
they have no content, instead of only 1 character wide. Reported by Paul
Orrock. [David]

=item *

The Bulk Edit and template code textarea fields no longer jump around as you
type in IE 6. [David]

=item *

The list of templates deployed is now reported properly after a successful
deploy. [Paul Orrock]

=item *

Searching by URI for related media works again. [David]

=item *

The results when searching for media or stories to relate are no longer tied
to the search for stories and media in general. [David]

=back

=head1 VERSION 1.10.1 (2006-03-20)

=head2 New Features

=over

=item *

Added a guide on how to profile Mason templates. See
F<contrib/template_profiling>. [Scott]

=item *

Added ContribType, Destination, and Preference SOAP modules. [Scott]

=item *

When a page finishes loading, the first text or textarea form field now
automatically gets the focus. [David]

=item *

Added upload and download feature to the template interface, so that templates
can optionally be uploaded or downloaded. Suggested by Chris Sutton. [David]

=back

=head2 Improvements

=over

=item *

When a story is previewed, any related media are distributed to the preview
server only if the C<AUTO_PREVIEW_MEDIA> F<bricolage.conf> directive is
disabled or the media documents need to be previewed. [David]

=item *

Added installation defaults for FreeBSD that will be used when the
C<USE_DEFAULTS> environment variable is set to "freebsd" during installation.
[Rod Taylor]

=item *

Added a C<make devclone> option which does the same as C<make clone> but
removes all of the locally previewed files, the F<data/obj> files, staging and
sandboxes. This means a large saving in download size for cloned production
systems. [Paul Orrock]

=item *

Added C<ALLOW_URIS_WITHOUT_CATEGORIES> F<bricolage.conf> directive to allow
URI formats not to include "%{categories}", which is otherwise rquired. Use
this directive with caution since it is not the recommended behaviour. [Paul
Orrock]

=item *

Added a tooltip to show the underlying Bricolage database ID when hovering
over a UUID in a story profile. This feature complements showing the UUID when
the hovering over the Bricolage ID in a desk view. [Paul Orrock]

=item *

Changed the database columns for the C<name>, C<key_name>, and C<description>
attributes of
L<Bric::Biz::ElementType::Parts::FieldType|Bric::Biz::ElementType::Parts::FieldType>
from C<VARCHAR> to C<TEXT>, since some folks will have field types with names
and key names longer than 32 characters. Reported by Nate Perry-Thistle.
[David]

=item *

Created two new make targets, "install_files" and "install_db", to allow the
files to be installed without doing anything with the database. Useful for
packagers who need to let users manually create the database. [Marshall]

=item *

Updated L<Bric::ElementAdmin|Bric::ElementAdmin> to be conversant in the
merging of element type sets and elements. That is, it now makes sense in the
context of Bricolage 1.10. Reported by Ryan O'Toole. [David]

=item *

The View/Edit link has been restored to stories, media, and templates on desks,
and the title has been returned to its status as a preview link. The URI is no
longer a link. [David]

=item *

Made the "Upload" section of the media profile valid XHTML styled with CSS.
[David]

=back

=head2 Bug Fixes

=over

=item *

Removed call to deleted component F<comp/widgets/qa/qa.mc> from the side
navigation component. This was only an issue when the C<QA_MODE>
F<bricolage.conf> directive was enabled. Reported by Derek Poon. [David]

=item *

Fixed the typo "Distribintion" in the side navigation. Thanks to Christian
Niles for the spot. [David]

=item *

Fixed some errors in and rearranged the SOAP schema in
L<Bric::SOAP|Bric::SOAP>. [Christian Niles]

=item *

Fixed a foreign key constraint on C<media_element.related_story__id> that was
pointing to C<media.id> instead of C<story.id>. Reported by Rod Taylor.
[David]

=item *

Fixed localization errors such as, "Can't use "for Published" as a method name
in bracket group," which appeared in searches and on desks. Thanks to Guido
Bülskämper for the spot! [David]

=item *

The database upgrade script now updates table permissions after executing all
of the scripts for each version to be upgraded, rather than after all of the
upgrade scripts have run, thus allowing later scripts to properly access
tables created by earlier scripts. Reported by Nate Perry-Thistle. [David]

=item *

Fixed some of the 1.8.9 upgrade scripts that run I<after> the 1.9.x upgrade
scripts to that they are properly compatible. [Nate Perry-Thistle, Rod Taylor,
and David]

=item *

L<Bric::Biz::ElementType|Bric::Biz::ElementType> loads again. [Nate
Perry-Thistle]

=item *

The C<MEDIA_UNIQUE_FILENAME> F<bricolage.conf> directive is now fixed so that
the file name creation comes after the ID generation and therefore correctly
saves the renamed file. [Paul Orrock]

=item *

Fixed the UI display in Firefox and IE. Particularly Meta Assets displaying
down the page in IE, stretching out the banner in desks, corrected side menu
position in IE and removed reference to broken images left in from the CSS
reworking. Also fixed textarea which was ignoring cols setting in IE and set
textarea col width for bulk edit to 80 wide, rather than 30 (although it
should expand with the window size in most browsers). [Paul Orrock]

=item *

Fixed the history so that clicking the return button in the UI no longer goes
back to the preview page when the preview page was the last page accessed.
[Paul Orrock]

=item *

The XML generated when exporting element types via SOAP no longer includes
the C<top_level> element twice, thus avoiding mysterious "no sites defined"
errors when attempting to import or update element types from that XML.
Reported by Nate Perry-Thistle. [David]

=item *

Reverting stories and media no longer leads to occasional errors such as,
"Too many Bric::Biz::Element::Container objects found". Reported by Simon
Wilcox. [David]

=item *

Disabled the "sticky" scroll bar in the story profile. It just didn't work
very well. [David]

=item *

The "Allow Multiple" checkbox and "Size" field in the "Add New Field" section
of the element type profile work again. Reported by Rod Taylor and Paul
Orrock. [David]

=item *

Multiple select lists no longer break the story and element profiles, and can
once again have their values properly changed from multiple to single to none.
Spotted by Rod Taylor. [David]

=item *

Desk pagination is now properly styled. [David]

=item *

Assets can once again be properly deleted from desks. [David]

=item *

Silenced status messages when previewing a media document under the
C<AUTO_PREVIEW_MEDIA> F<bricolage.conf> directive. Reported by Rod Taylor.
[David]

=item *

Cancelling the checkout of an media document now deletes any new file that has
been uploaded and, if the C<AUTO_PREVIEW_MEDIA> F<bricolage.conf> directive is
enabled, re-previews the previous version of the media file. [David]

=item *

The autopopulated fields for image element types are now created when a new
image element type is created. This was made possible by moving the selection
of media type (Image, Audio, Video, or Other Media) to the New Element Type
screen, where it is now part of the "Content Type" select list, which also
includes the Story and Subelement options. As a result, one can no longer
change the media type in an existing element type (not that it ever made sense
to do so). Reported by Paul Orrock. [David]

=item *

Fixed the selection of text triggered by the Find dialog box on Mozilla and IE
(although I find IE to be a bit broken in this way). [David]

=item *

Fixed the size of the preview links on desks/My workspace. [David]

=item *

Failed jobs can once again be cancelled. Reported by Rod Taylor. [David]

=item *

Publishing multiple versions of a document before any of the publish jobs for
those versions are executed no longer leads to publishing errors when the
older version is published. Thanks to Rod Taylor for the spot! [David]

=item *

The element trace generated for burn errors (those created by
C<< $burner->throw_error() >>) now use the C<place> attribute of the element
where the error was thrown, rather than the C<object_order>, since C<place>
corresponds to the "Position" select list orderings in the UI, and therefore
makes it much simpler to figure out where the error is. [David]

=item *

Output channels with includes can now be created via the output channel SOAP
interface. [David]

=item *

Fixed the category SOAP interface to support post-1.10 URIs that support paths
ending in a slash. [David]

=item *

Fixed the publication of multiple documents at once from a publish desk so
that documents that are both selected and related to other documents don't get
skipped. [David]

=item *

The "Find Templates" results now display the template URI rather than its file
name, to be consistent with the template profile. Reported by Marshall.
[David]

=back

=head1 VERSION 1.10.0 (2006-01-23)

=head2 Improvements

=over

=item *

Eliminated letter graphics for "Published" and "Deployed" labels in story,
media, and template managers in favor of localizable characters. [David]

=item *

Moved the C<display_pages()> method from subclasses to
L<Bric::Util::Burner|Bric::Util::Burner>. Each subclass must implement a
C<display_element()> method for it to work; this means that it works for all
current burners except the HTML::Template burner, which manages pages
differently. This also fixed pagination issues in the Template Toolkit and PHP
burners. [David]

=item *

Completely updated L<Bric::Templates|Bric::Templates> and
L<Bric::AdvTemplates|Bric::AdvTemplates>, with expanded API documentation and
examples in Mason, Template Toolkit, and PHP. [David]

=item *

Refactored the left navigation code to perform better and be easier to
maintain. It now also sorts the admin menu items in alphabetical order by the
localized name of each. [David]

=item *

Updated the UI to fix Internet Explorer glitches. [Marshall]

=item *

The Element Type profile is now much smarter about displaying site
associations with an element type. If the user has access to only one site and
the element type is associated with no more than one site, then the "Sites"
section won't be displayed, but the primary output channel can be selected via
a radio button among the list of output channels. If the user has access to
more than one site or if the element type is associated with more than one
site, the "Sites" section will be displayed and the primary output channel can
be selected from a select list for each site. [David]

=item *

The Element Type Manager now displays the key name for each element, in
addition to its name, and instead of the its description. [David]

=item *

Added C<RELATED_DOC_POD_TAG> F<bricolage.conf> directive, so that users don't
have to be limited to seeing related stories and related media represented by
C<=related_story_uuid> and C<=related_media_uuid>. Just set it to "uuid",
"uri", "url", or "id" to get a different tag. [David]

=item *

Optimized comparison of new and old attribute values when setting attributes.
Based on an example sent by Curtis "Ovid" Poe. [David]

=item *

Added C<site> parameter for a site name to the list() methods of the story,
media, and template classes. [David]

=item *

Added F<republish_by_uri> contrib script. [David and Mark]

=item *

Field types can now have their widgets changed via the UI as well as via SOAP.
So you can change a "text" widget to "textarea", for example. [David]

=item *

Fixed the options in the "Default Asset Sort" to be more up-to-date. [David]

=item *

Updated the context-sensitive online help avaialable by clicking the
"Help"button at the top of the Bricolage UI. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.9.1 "Peeves" (2005-10-28)

=head2 New Features

=over

=item *

Added support for the C<ANY()> function to pass multiple possible values for a
given parameter to the C<list()>, C<list_ids()>, and, where pertinent,
C<href()> methods in the following classes:

=over

=item L<Bric::Dist::Action|Bric::Dist::Action>

=item L<Bric::Dist::ActionType|Bric::Dist::ActionType>

=item L<Bric::Dist::Resource|Bric::Dist::Resource>

=item L<Bric::Dist::Server|Bric::Dist::Server>

=item L<Bric::Dist::ServerType|Bric::Dist::ServerType>

=item L<Bric::Util::Alert|Bric::Util::Alert>

=item L<Bric::Util::Alerted|Bric::Util::Alerted>

=item L<Bric::Util::AlertType|Bric::Util::AlertType>

=item L<Bric::Util::AlertType::Parts::Rule|Bric::Util::AlertType::Parts::Rule>

=item L<Bric::Util::Event|Bric::Util::Event>

=item L<Bric::Util::EventType|Bric::Util::EventType>

=item L<Bric::Util::Job|Bric::Util::Job>

=item L<Bric::Util::MediaType|Bric::Util::MediaType>

=item L<Bric::Util::Pref|Bric::Util::Pref>

=item L<Bric::Util::Priv|Bric::Util::Priv>

=item L<Bric::Util::UserPref|Bric::Util::UserPref>

=back

[David]

=item *

Added C<serialize_to_pod()> and C<update_from_pod()> methods to the container
element class. These support a pseudo-pod syntax that enables a complete
hierarchy of elements to be edited, including links to related stories and
media, in a single stream of text. [David]

=item *

Converted "Bulk Edit" in the UI to use the new POD syntax supported by the
element classes and eliminated the old "Super Bulk Edit" interface since it
became redundant. [David]

=item *

Added the "Include deleted" checkbox to Advanced Search in "Find Stories,"
"Find Media," and "Find Templates" intefaces; this allows searching for and
reactivating deleted stories, media, and templates. [Scott]

=item *

Added the "Subelement" select list to the "Find Stories" interface, to allow
searching on stories by the types of subelements they contain. [Scott]

=item *

The C<Order> and C<OrderDirection> parameters to the C<list()> methods of the
story, media, and template classes can now be specified as array references so
as to sort on more than one attribute. [David]

=item *

Added C<Order>, C<OrderDirection>, C<Limit>, and C<Offset> parameters to the
C<list()> method of Bric::Util::Event. [David]

=item *

Added diff support to the UI to see changes between versions of templates,
stories, and media documents. [David]

=item *

Added JavaScript-powered Find/Replace dialog box to Bulk Edit in the element
profile and to the template profile. The "Replace All" function should work
very well everywhere, while the "Find" function relies on IE- and
Mozilla-specific features to properly highlight found text in the textarea box
searched. Other browsers will get an alert indicating at what character the
match was found. [David]

=item *

Added new "Code Select" custom field allows you to add arbitrary Perl code to
generate the items in a select list. This is great for dynamically pulling in
choices from another database, LDAP directory, or anything else you can get at
from Perl code. [Scott]

=item *

Added ability to shelve a story from a desk or My Workspace. [David]

=item *

Added C<reset()> method to L<Bric::Util::Job|Bric::Util::Job> and a "Reset"
checkbox in the job profile in the UI so that failed jobs can easily be
re-attempted. [David]

=item *

Added "Cheat Sheet" dialog box to Bulk Edit that displays the entire hierarchy
of available subelements and fields as the pseudo-pod "tags" available for use
in bulk editing content. [David]

=back

=head2 Improvements

=over

=item *

Added C<related_story_id> and C<related_media_id> parameters to the C<list()>
method of the story and media classes to search for stories and media that
have a given story or media ID or list of IDs as relateds. Based on a patch
from Rod Taylor. [David]

=item *

Moved story, media, and template notes into a column in the appropriate
instance table, instead using attributes, and then removed the story, media,
and template attribute objects. This is a much more efficient use of the
database and eliminates a lot of cruft. [David]

=item *

Added C<has_notes()> method to L<Bric::Biz::Asset|Bric::Biz::Asset> (and
therefore its story, media, and template subclasses) as a more efficient way
of determining whether an asset has notes for any of its versions than calling
the C<get_notes()> method. [David]

=item *

Added C<note> parameter to the C<list()> method of the story, media, and
template classes. Unlike most of the parameters, this one will return assets
with C<any> of their versions having a note matching the C<note> parameter.
[David]

=item *

Updated search documentation and wrote tests for:

=over

=item L<Bric::Dist::ActionType|Bric::Dist::ActionType>

=item L<Bric::Util::Alert|Bric::Util::Alert>

=item L<Bric::Util::Alerted|Bric::Util::Alerted>

=item L<Bric::Util::AlertType::Parts::Rule|Bric::Util::AlertType::Parts::Rule>

=item L<Bric::Util::Event|Bric::Util::Event>

=back

[David]

=item *

The new "Repreview" iframe now works for the links in subelements, too.
[David]

=item *

Category and story URIs now all end in a slash. This is so that they all
behave consistently with root categories and home page URIs, and so that they
properly indicate directories. Note that this does not apply if the
C<STORY_URI_WITH_FILENAME> F<bricolage.conf> directive has been enabled.
B<Note to Templaters:> You may need to modify your templates to take into
account that story and category URIS now end in a slash, if you were appending
a slash in your templates or searching on category URIs for related stories.
[David]

=item *

Now require Perl 5.8.0 or newer. Realistically it should only be 5.8.3 or
newer. [David]

=item *

Added support for searching on UUIDs to the story and media classes. [David]

=item *

Added support for searching on URIs in the story class and modified the same
parameter in the media class to search I<all> possible URIs for media, not
just the URI associated with the primary output channel. [David]

=item *

The select list of fields and subelements that can be added to an element now
lists all of the fields and subelements in alphabetical order. [David]

=item *

Improved JavaScript word and character counts in Bulk Edit so that they're
actually accurate, including when POD tags are present. [David]

=item *

The word and character counts in Bulk Edit are now kept up-to-date as you
type. [David]

=item *

Added the current element object to exception object in C<throw_burn_error>
and, by extension the burner C<throw_error()> method. Now a kind of breadcrumb
trail will illustrate where in the element hierarchy of a story a burn error
was thrown. (Note: this only works for exceptions thrown by
C<throw_burn_error>.) [Scott]

=item *

Fixed the C<get_data()> and C<get_container()> element methods so that, in
list context, they return C<undef> instead of an empty list when there is no
corresponding field or element. This will be especially useful in templates,
where it will prevent errors such as Mason's, "Odd number of parameters passed
to component expecting name/value pairs." [David]

=item *

Renamed the C<related_instance_id> attribute of elements to
C<related_story_id>, for parity with C<related_media_id>--not to mention the
C<get_related_story()> method. The C<get_related_instance_id()> and
C<set_related_instance_id()> accessor methods remain in place for purposes of
backwards compatibility. [David]

=item *

Renamed "Element" to "Element Type" and "Element Type" to "Element Type Set".
This is to avoid confusing element types, which define the structure of
elements, and elements, which are contain content and are based on element
types. These are not ideal names, but at least we now have something different
to call them. The old C<get_element()> method and the accessors that get and
set C<element_id> or C<element__id> have also been renamed to
C<get_element_type()> and to access C<element_type_id>. [David]

=item *

Changed the attributes and objects that refer to the
Bric::Biz::ElementType::Parts::FieldType object in
Bric::Biz::Asset::Parts::Tile::Data from C<element_data_id> and
C<get_element_data()> to C<field_type_id> and C<get_field_type()>. [David]

=item *

Made the scroll bar "sticky" in the Story Profile, so that when you save a
story, the reload will scroll back to the same spot in the story profile where
you left odff. [Scott]

=item *

Added a "dialog box" widget for generating JavaScript-driven dialog boxes. The
buttons are nicely styled to match the Bricolage UI, and can be configured to
trigger JavaScript functions. Dialog boxes can also be dragged around the
browser window by grabbing their title bars. Used by the new Find/Replace and
Bulk Edit Cheat Sheet features, but will likely be used in other contexts in
the future. [David]

=item *

Normalized story and media elements and fields so that they no longer store
copies of their names, key names, and descriptions--and, in the case of
fields, the autopopulated and sql_type attributes--since these are actually
element type and field type attributes easily referenced in the element type
and field type tables. This change significantly reduces the size of the
database and has the potential to increase performance when getting and
setting field values, especially during publishes. [David]

=item *

Major refactoring of the field types class,
L<Bric::Biz::ElementType::Parts::FieldType|Bric::Biz::ElementType::Parts::FieldType>.
Attributes that describe how fields should be displayed are no longer stored
in a separate attribute object, but as true attributes of field type objects.
This makes them much more efficient in terms of database access. [David]

=item *

Added fuller management of field types in the Element Type Manager, such as
supporting the setting of a default value in a checkbox field in the field
profile. [David]

=item *

Added much more fine-grained field type management to the Element Type SOAP
interface. More field attributes can now be updated via SOAP. For example, one
can now change the widget type from "text" to "textarea". These improvements
are thanks to the normalization of the element type and field type classes.
Note that there are a number of new XML elements, and some of the existing
ones have changed names, but we have tried to preserve backwards compatibility
as much as possible. [David]

=item *

Added many new tests for the element type, field type, and element classes.
[David]

=item *

Renamed "Element Data" to "Field Type". [David]

=item *

Renamed a number of tables and appropriate foreign key columns, indexes,
constraints, and the like, to better reflect the names used for these things
in general. The tables renamed are:

=over

=item element to element_type

=item at_type to field_type

=item story_container_tile to story_element

=item story_data_tile to story_field

=item media_container_tile to media_element

=item media_data_tile to media_field

=item formatting to template

=back

[David]

=item *

Fixed a bunch of inconsistently named foreign key indexes. [David]

=item *

Renamed the Element and Element Type classes as follows:

=over

=item *

Bric::Biz::AssetType is now L<Bric::Biz::ElementType|Bric::Biz::ElementType>.

=item *

Bric::Biz::AssetType::Parts::Data is now
L<Bric::Biz::ElementType::Parts::FieldType|Bric::Biz::ElementType::Parts::FieldType>.

=item *

Bric::Biz::Asset::Business::Parts::Tile is now
L<Bric::Biz::Element|Bric::Biz::Element>.

=item *

Bric::Biz::Asset::Business::Parts::Tile::Container is now
L<Bric::Biz::Element::Container|Bric::Biz::Element::Container>.

=item *

Bric::Biz::Asset::Business::Parts::Tile::Data is now
L<Bric::Biz::Element::Container|Bric::Biz::Element::Field>.

=back

They now properly reflect what they're called in the UI, in SOAP, and in the
database. The old classes have been changed to simply inherit from the new
classes, so as to maintain backwards compatibility. [David]

=item *

Changed various C<get_data()>, C<set_data()> C<del_data()> and such methods to
C<get_field_types()>, C<get_value()>, C<set_value()>, C<add_field_types()>,
etc., to disambiguate fields from field types more consistently. These changes
are to the interfaces of L<Bric::Biz::ElementType|Bric::Biz::ElementType>,
L<Bric::Biz::ElementType::Parts::FieldType|Bric::Biz::ElementType::Parts::FieldType>,
and L<Bric::Biz::Element::Container|Bric::Biz::Element::Container>. The old
methods are of course left in place for purposes of backwards compatibility.
[David]

=item *

Added C<get_values()> and C<set_values()> methods to the field class
(L<Bric::Biz::Element::Field|Bric::Biz::Element::Field>) to make getting and
setting multivalue fields easier and more centralized. [David]

=item *

Removed the unused and meaningless C<referenced> attribute from
L<Bric::Biz::ElementType|Bric::Biz::ElementType>. [David]

=item *

Removed the unused and meaningless C<publishable> and C<map_type_id>
attributes from
L<Bric::Biz::ElementType::Parts::FieldType|Bric::Biz::ElementType::Parts::FieldType>.
[David]

=item *

Turned Bric::Biz::ATType into an appendix: something that's there, and may
have served a purpose in the past, but isn't needed now. All of its attributes
have been moved to L<Bric::Biz::ElementType|Bric::Biz::ElementType>, and you
should still be able to get the ATType object from existing elements, but new
elements won't need it anymore. It has been removed from the UI, but the SOAP
interface and the class itself remain for now. Bric::Biz::ATType will be
completely removed in a future version of Bricolage. [David]

=item *

The Element Type profile no longer displays the "Sites" section if there is
only one site, and no longer displays the output channel section if there is
only one output channel. [David]

=item *

Renamed Bric::SOAP::ElementType to Bric::SOAP::ATType, Bric::SOAP::Element to
L<Bric:SOAP::ElementType|Bric:SOAP::ElementType>, and
Bric::App::Callback::Profile::ElementData to
L<Bric::App::Callback::Profile::FieldType|Bric::App::Callback::Profile::FieldType>.
[David]

=item *

Added support for typical Windows character encodings. This means that users
can select "Windows Western (CP1252)" as their encoding in order to fix
gremlin characters pasted from Microsoft Word. [David]

=item *

It is now fatal to submit characters in an invalid encoding. For example, if a
user is using UTF-8 (the default) but pastes the contents of a Word document
with an m-dash (a CP1252 character), Bricolage will now throw an exception. It
probably threw an exception from the database in the past, but now we're
throwing one earlier. The solution for such a user is to of course select the
proper encoding in their "Character Set" preference. [David]

=item *

New categories now inherit all group memberships and permissions granted to
access assets in the category from their parent categories. This makes it far
easier for users with CREATE permission to categories to create new categories
without having to then edit group memberships and user group permissions to
make them the same as the parent's permission, which is what is usually
wanted. Of course, existing categories are unaffected, and if user needs
different group memberships or permissions than the parent, she will still
have to edit them. [David]

=item *

F<bric_republish> now uses the C<published_version> Bric::SOAP::Workflow
parameter to always republish the last version of a story to be published.
This means that even if a story is checked out, it can be republished without
interfering with the checkout.

=item *

The User and Contributor managers in the UI now use the List Name Format
preference to display the whole names for users and contributors. This allows
users to easily see whatever name parts they need by simply changing their
List Name Format preferences. [David]

=item *

Alert emails now use an email address, if one can be found, for the user who
triggered the alert event for the From header in the alert email. The
C<ALERT_FROM> F<bricolage.conf> directive is still used as the fallback.
[David]

=item *

The C<pre_path> and C<post_path> attributes of output channels have been
eliminated, since they can now be used directly in the URI formats. [David]

=item *

The admin tools are now listed in alphabetical order in the side navigation of
the UI. [David]

=item *

Added C<get_primary_category()> alias for C<get_category()> in the media
document class so as to make it more like the story class, thus making
dispatch simpler. [David]

=item *

Users creating media documents from within a related media element (because
the C<RELATED_MEDIA_UPLOAD> F<bricolage.conf> directive has been enabled and
they have the proper permissions) are now redirected to the "New Media"
profile when the new file has been uploaded, so that the element type,
category, cover date, priority, etc. can be changed. [David]

=item *

Story and media cover dates are now versioned. [David]

=item *

Output channels are now associated with burners and can only include other
output channels associated with the same burners. Element types are no longer
associated with burners at all. [David]

=item *

Renamed Bric::Biz::Asset::Formatting to
L<Bric::Biz::Asset::Template|Bric::Biz::Asset::Template>. [David]

=item *

Added the C<TT_OPTIONS> F<bricolage.conf> directive to allow Bricolage
administrators to pass template toolkit directive options to the Template
object when it is instantiated by the Template Toolkit burner. [David]

=item *

Added the C<COMPILE_EXT> option to the instantiation of the Template Toolkit
object in the Template Toolkit burner. This will cache compiled versions of
the templates so that they do not have to be parsed and compiled every time a
story is published. This should make the TT burner substantially faster.
[David]

=item *

Publish and distribution jobs are now tied to a specific version of a story or
media document, rather than the media document itself. This will allow a whole
series of publishes for versions of a document to be scheduled for execution
over time, as well as help to protect currently checked-out documents from
being mysteriously removed from workflow by scheduled publishes being
executed. Sponsored by Freerun Technologies. [David]

=item *

Searches now are remembered for each manager in the UI for as long as a
session lasts. So if you perform a search for element types, and then do a
search for stories or output channels, the last results you saw in the element
type manager will be there again when you return to it. [David]

=item *

Eliminated need for HTTP::BrowserDetect, since the UI is now completely
browser-neutral. [David]

=item *

Media files can now be uploaded in the New Media profile. [David]

=item *

Added events for adding subelement element types to element types. [David]

=item *

Any symbols exported by C<PERL_LOADER> code, plus those exported by
C<Bric::Util::DBI qw(:junction)>, are now imported into the Template Toolkit
stash for direct use in Template Toolkit templates, and into the PHP global
context for direct use in PHP templates. For example, the C<ANY> function can
now be used directly in TT templates and as C<$ANY()> in PHP templates. The
burner constants C<PUBLISH_MODE> and C<PREVIEW_MODE> can also be used
C<$PUBLISH_MODE()> and C<$PREVIEW_MODE()> in PHP) if the default
C<PERL_LOADER> in F<bricolage.conf> is left in place. But TT can't have
multiple symbols with the same names, so for each symbol exported, it adds to
the stash the first one it finds in this order: CODE, HASH, ARRAY, IO, GLOB,
FORMAT, and SCALAR. Use of imported functions in PHP templates requires
PHP::Interpreter 1.1.0 or later. [David]

=item *

The story, burner, element, and content variables are now globals in PHP
templates, rather than each being stored in a global $BRIC associative array,
which is now gone. This brings the style of PHP templates more in line with
that of Mason and Template Toolkit templates. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.9.0 "Punkin" (2005-08-19)

=head2 New Features

=over

=item *

Added C<MASON_INTERP_ARGS> F<bricolage.conf> directive to allow arguments to
be passed to the Mason template interpreter. [Scott]

=item *

Added support for sub-second precision to date and time management in
Bricolage. This means that dates can be stored in the database with
microsecond precision. This was done by modifying Bricolage's date and time
handling to use the DateTime module from CPAN under the hood. The upshot is
that you can use the full suite of C<strftime> formats supported by DateTime,
including the formats for milliseconds and microseconds. Sponsored by Alinghi.
[David]

=item *

Added new "Precision" option to DateTime fields added to elements and
contributor types. The supported precisions are "Year", "Month", "Day",
"Hour", "Minute", "Second", "Millisecond", and "Microsecond". For purposes of
backwards compatibility, the default precision for custom DateTime fields is
"Minute". Sponsored by Alinghi. [David]

=item *

Added C<preview_another_all_ocs()> and C<blaze_another()> to
Bric::Util::Burner. The former executes a preview for all of the output
channels a document is associated with. The latter takes a document for its
argument and calls C<publish_another()> in PUBLISH_MODE and
C<preview_another_all_ocs()> in PREVIEW_MODE. [Serge Sozonoff]

=item *

Added C<$INSTALL_VERBOSITY> makefile environment variable that, when set to
"QUIET", eliminates many of the questions asked during installation and
cloning, falling back on the default values. [Rod Taylor & Andrea Rota]

=item *

Added C<$USE_DEFAULTS> makefile environment variable that, when used with
C<$INSTALL_VERBOSITY>, will use platform-specific answers to all of the
installation questions. This allows for completely silent, customizable
installations, which are necessary for packagers. [Marshall]

=item *

Added C<make dev> makefile target for installing a development version straight
out of a Subversion checkout. It performs a standard installation, then
symlinks bin/, comp/ and lib/ back to the Subversion checkout. [Marshall]

=item *

Added C<RELATED_MEDIA_UPLOAD> F<bricolage.conf> directive that allows editors
to upload media files directly into an element profile if they have permission
to create media and to access a media workflow. This makes it a much simpler
process for editors to quickly associate media with story documents. The
uploaded media files will be created based on the media type element selected
from a select list, and given the same category, cover date, and priority as
the current document. Enabled by default. [JoE<atilde>o Pedro and David]

=item *

Added the element type and output channel modules to the SOAP interface.
[Scott]

=item *

Added the C<ENABLE_GZIP> F<bricolage.conf> directive to turn on compression of
the UI pages through C<mod_gzip>. This results in pages as much as fifteen
times smaller, with minimal extra server load. If C<mod_gzip> is found during
installation, the appropriate C<LoadModule/AddModule> lines will be added to
F<httpd.conf>. Disabled by default. Suggested by Rod Taylor. [Marshall]

=item *

Added "Show Alpha Search" preference that determines whether the alpha search
("A | B | C | ... [All]") links should be shown. The alpha search isn't very
useful because you can type the first letter in the textbox (or "%" for "All")
for the same results, and it supports only the ASCII alphabet. Alpha search is
now off by default. [Marshall]

=item *

Added C<MEDIA_UNIQUE_FILENAME> F<bricolage.conf> directive to allow the
file name of media documents to be set to a unique, automatically generated
file name on upload, (off by default). Also added the C<MEDIA_FILENAME_PREFIX>
directive for setting a prefix word, such as "media", to be prepended to the
file name if desired (off by default). [Paul Orrock / Digital Craftsmen]

=item *

Added support for the C<ANY()> function to pass multiple possible values for a
given parameter to the C<list()>, C<list_ids()>, and, where pertinent,
C<href()> methods in the following classes:

=over

=item L<Bric::Biz::ATType|Bric::Biz::ATType>

=item L<Bric::Biz::AssetType|Bric::Biz::AssetType>

=item L<Bric::Biz::AssetType::Parts::Data|Bric::Biz::AssetType::Parts::Data>

=item L<Bric::Biz::Category|Bric::Biz::Category>

=item L<Bric::Biz::Contact|Bric::Biz::Contact>

=item L<Bric::Biz::Keyword|Bric::Biz::Keyword>

=item L<Bric::Biz::Org|Bric::Biz::Org>

=item L<Bric::Biz::Org::Parts::Addr|Bric::Biz::Org::Parts::Addr>

=item L<Bric::Biz::Org::Person|Bric::Biz::Org::Person>

=item L<Bric::Biz::Org::Source|Bric::Biz::Org::Source>

=item L<Bric::Biz::OutputChannel|Bric::Biz::OutputChannel>

=item L<Bric::Biz::OutputChannel::Element|Bric::Biz::OutputChannel::Element>

=item L<Bric::Biz::Person|Bric::Biz::Person>

=item L<Bric::Biz::Person::User|Bric::Biz::Person::User>

=item L<Bric::Biz::Site|Bric::Biz::Site>

=item L<Bric::Biz::Workflow|Bric::Biz::Workflow>

=item L<Bric::Biz::Workflow::Parts::Desk|Bric::Biz::Workflow::Parts::Desk>

=item L<Bric::Util::Grp|Bric::Util::Grp>

=back

More classes will support it soon! [David]

=item *

Added support for associating secondary categories and output channels when
cloning a story. Sponsored by Alinghi. [David]

=item *

Added support for adding secondary output channels to a new clone by selecting
a group of output channels. All output channels in that group that are allowed
by the story element will be associated with the clone. This is an easy and
accurate way to add a bunch of output channels to a clone at once. Users must
have READ access to each listed output channel group. Sponsored by Alinghi.
[David]

=item *

Added C<MEDIA_UPLOAD_LIMIT> F<bricolage.conf> directive for setting a size
limit on uploaded media files. [Scott]

=item *

The URI formats are now more flexible. You can now use many more parts of the
cover date in the URI, and in whatever format you like. So you could have a
format of "/%{categories}/%Y-%m-%d/" and end up with the URI
"/foo/bar/2004-09-22/" if you wanted. Or even "/%{categories}/%Y/%V/" to get
the week number as part of the URI. You can also include your own text,
similar to the URI Prefix and URI Suffix fields, anywhere in the URI (e.g.
foobar in "/%{categories}/%Y/%m/foobar/%{slug}/". Suggested by David.
[Marshall]

=item *

Added a frame on top of the preview window with a "Repreview" link. This is
useful for previewing changes when you're developing templates. Rather than
having to save the template, go back to the workspace, repreview, and then go
back to the template profile, you can preview the story, then edit the
template and click "Repreview" as necessary after each save. [Marshall]

=item *

Added a pluggable authentication system. New authentication engines can be
created by simply implementing a module named C<Bric::Util::Auth*>, where "*"
is the name of the authentication scheme. The new scheme can then be used by
adding it to the new C<AUTH_ENGINES> F<bricolage.conf> directive. By default
only the existing authentication scheme is used. Sponsored by Kineticode.
[David]

=item *

Added support for authentication to Bricolage against an LDAP server. The new
C<LDAP_*> F<bricolage.conf> directives make it simple to configure Bricolage
to authenticate against any LDAP server. Includes support for authenticating
users only if they are members of a specific user group in the LDAP database.
Users must still exist in Bricolage, however. Sponsored by Kineticode. [David]

=item *

Added support for multiple WYSIWYG editors. The C<ENABLE_HTMLAREA>
F<bricolage.conf> directive has been replaced by the C<ENABLE_WYSIWYG> and
C<WYSIWYG_EDITOR> directives. You can now choose between htmlArea 3 and the
new Xinha, a more active fork of htmlArea (recommended). More editors possibly
coming soon. See L<Bric::Admin|Bric::Admin> for details. [Marshall]

=item *

Added C<AUTO_PREVIEW_MEDIA> F<bricolage.conf> directive. Enabling this
directive allows media files uploaded to a media document to be distributed to
all relevant preview servers as soon as the media document is saved. Sponsored
by Alinghi. [David]

=item *

Added a PHP burner. Implemented by George Schlossnagle of Omni TI consulting.
Sponsored by PT.com. [George Schlossnagle]

=item *

Added UUIDs to story and media documents. A UUID is a universally unique
identifier. The format for UUIDs has been described in RFC 4122, ITU-T Rec.
X.667 and ISO/IEC 11578:1996. In Bricolage, they are generated by
L<Data::UUID|Data::UUID>.

=back

=head2 Improvements

=over

=item *

Creating a template that was deactivated now reactivates it instead of just
giving an error message. [Scott]

=item *

The "User Override" screen has been integrated into the "Users" screen since
the two pages are mostly redundant except for a few links. [Marshall]

=item *

User overrides are now recorded in the event log. Suggested by David.
[Marshall]

=item *

The UI now shows which user is logged in and includes a link to the user's
profile at the top of each page, above the log out button. Suggested by Philip
Brown. [Marshall]

=item *

All of the old "NUMERIC" columns have been removed from the database and
replaced with the more appropriate (and faster) "INTEGER", "SMALLINT", and
"BOOLEAN" data types. [Neil Conway & David]

=item *

Added C<exclude_id> parameter to the C<list()> methods of the story, media,
and template classes. This parameter can be used to exclude one or more asset
IDs from the list of objects returned by the call to C<list()> and friends.
Suggested by Curtis Poe. [David]

=item *

The C<get_desk_stamps()> method in the asset classes has been removed (it was
deprecated in Bricolage 1.8.4). The same goes for the C<required_satisfied()>
method in Bric::Biz::Workflow. Thanks to Marshall Roch for the spot! [David]

=item *

Users now must have at least READ permission to sources to add them to
stories. If upgrading from an earlier version of Bricolage, for purposes of
backward compatibility, members of the "All Users" group (that is to say, all
users) will be granted READ access to all sources. Change this permission to
limit access as appropriate. For new installations of Bricolage, the default
"Story Editors" and "User Producers" groups have READ permission to all
sources. Suggested by Simon Wilcox. [David]

=item *

There is now a "Preserve Template" (disabled by default) option in Bulk Edit
that retains leading spaces, trailing spaces, and line breaks. With this
option set, you can, for example, paste in poetry without it all ending up on
one line. [Marshall]

=item *

URI formats now require that the categories be a part of the format. [David]

=item *

When using the command line tools, you can now opt to be prompted for your
password rather than entering it on the command line, which would store your
plain text password in the shell history. [Marshall]

=item *

Added tests for the burners. This was important for thoroughly testing the new
PHP burner, but it will keep the other burners functioning well from here on
in, as well. [David]

=item *

Moved the C<burn_again> attribute from Bric::Util::Burner::Mason to
Bric::Util::Burner, since it could be useful to other burners, and since
Bric::Util::Burner had knowledge of it, anyway. [David]

=item *

The HTML::Template burner now sets parameters for all attributes of a story as
returned by the C<my_meths()> method of the story class, rather than just the
story title. So, for example, you can now use <tmpl_var primary_uri> or
<tmpl_var cover_date> with out creating a F<.pl> template to set them up.
[David]

=item *

Refactored the separate C<_add_resource()> methods in each of the burner
subclasses int Bric::Util::Burner itself. [David]

=item *

Arguments can now be passed to the C<display_element()> method of the Template
Toolkit burner and they will be set up as variables in the stash of the
execution context of the element template.

=item *

Category templates in the HTML::Template burner now cascade just like in all
the other burners, rather than stopping at the first category template found
in the category URI. Users of HTML::Template templates should take note of
this if they have more than one category template in their category URIs.
[David]

=item *

The HTML::Template burner now has access to both the related story and the
related media URIs via the C<rel_story_uri> and C<rel_media_uri> variables.
The old C<link> variable has been deprecated, since it cannot handle an element
that has both a related media and a related story. [David]

=item *

Major interface clean-up. The UI is finally mostly valid XHTML and uses CSS
for all styles. The C<USE_XHTML> directive, added in 1.7.0, is no longer used.
The file sizes of some pages have been reduced by as much as 70%, offering
improved page load times. Also, it will now be much easier to customize
colors, etc. by customizing the CSS stylesheet. [Marshall]

=item *

The desks/My Workspace have been slightly modified to be more usable. Most
notably, the "View" and "Edit" links (depending on checkout status) have been
moved to the asset's title, where the preview link formerly was, the
"Category" line has been replaced with "Primary URI", and the URI itself is
the preview link. Also, the "Site" line now only shows up when there is more
than one site. [Marshall]

=item *

Added C<MASON_STATIC_SOURCE> F<bricolage.conf> directive to enable static
sources in the Mason-powered UI. Enabling this directive can eliminate many
file system stats on every request, thus increasing performance. It's disabled
by default, but you should turn it on now! [David]

=item *

Changed the names of the attributes in Bric::Biz::AssetType and
Bric::Biz::AssetType::Parts::Data that have double underscores to have only
single underscores. The double underscores are still supported for the sake of
backwards compatibility, but are no longer required. [David]

=item *

Updated search documentation and wrote tests for:

=over

=item L<Bric::Biz::Contact|Bric::Biz::Contact>

=item L<Bric::Biz::AssetType::Parts::Data|Bric::Biz::AssetType::Parts::Data>

=item L<Bric::Biz::Org::Parts::Addr|Bric::Biz::Org::Parts::Addr>

[David]

=back

=back

=cut

##############################################################################

=head1 VERSION 1.8.11 (2006-06-19)

=head2 Improvements

=over

=item *

The C<throw_error()> burner method now accepts a list of arguments for an
error message, rather than only a single argument. It will concatenate them
all together so that you don't have to. [David]

=item *

Added check to require C<< Bric::Biz::Asset::Business->add_contributor >>'s
first argument to be a C<Bric::Util::Grp::Parts::Member::Contrib> if it's
an object (it could also be an ID). [Scott]

=item *

Added F<README.Ubuntu>. [Christian Muise]

=item *

Silenced warnings from L<Net::SFTP|Net::SFTP> when distributing via SFTP.
[David]

=item *

The metadata for related media now include preview links. The same goes for
the metadata about a media document when editing a subelement of that media
document in the media profile. [David]

=item *

The status message when a document is published now reports the site with
which the document is associated, to help distinguish documents from their
aliases in the status message. Reported by Marshall. [David]

=item *

Added C<get_site()> to L<Bric::Biz::Asset|Bric::Biz::Asset>, and therefore to
the story, media, and template classes. Suggested by Marshall. [David]

=item *

Added support for the the C<oc_id> parameter to
L<Bric::Dist::Resource|Bric::Dist::Resource> to simplify looking up stale
story and media files for expiration. [David]

=back

=head2 Bug Fixes

=over

=item *

My Workspace now remembers the sort order of assets just as well as desks do.
[David]

=item *

Added more code to the C<inst/upgrade/1.8.9/fix_publish_status.pl> upgrade
script to better cover the possible variations in publish status inaccuracies.
[Brad Fox, Brad Harder, & David]

=item *

Distribution via any mover other than "File System" now correctly strips off
port numbers from the host name. This is most useful when using FTP, SFTP, or
WebDAV to distribute to a preview server serving content from an alternate
port. Reported by Doug Dawson. [David]

=item *

If run as root, C<make clone> now becomes the PostgreSQL system user before
cloning the database, so that it should work properly where PostgreSQL is
configured to use "ident" authentication. [David]

=item *

The list of desks that appear for a given workflow in the navigation iframe
are now properly updated when a new desk is added to the workflow. [Alexey
Dvoychenkov]

=item *

The side navigation no longer shows the "New Alias" links to users who don't
have the proper permissions (CREATE on the start desk). (bug 1203) [Marshall]

=item *

The code of a template no longer disappears when you click "Trail" in the
Template Profile. (bug 1204) [Marshall]

=item *

F<bric_soap> is now more intelligent about parsing IDs from XML elements with
either single or double quotes, and from multiple tags. [Christian Niles and
David]

=item *

Failing to fill in either the "To" or "Bcc" fields of an Email distribution
action no longer throws you back a screen, but stays in the Email action
profile. Reported by Scott. [David]

=item *

Fixed media publishing so that when a media document is published to more than
one output channel, I<and> there are differences in the URIs for that media
document between the output channels, that they won't trigger the expiration
of each other's files. Reported by Rod Taylor. [David]

=item *

Fixed bug where users granted CREATE permission were unexpectedly allowed to
PUBLISH items on the Publish Desk. [Christian Niles]

=item *

F<bric_queued> now works with all burners, not just the Mason burner. Reported
by Christian Niles. [Scott]

=item *

A required field deleted from an element definition will now be deletable in
the stories and media in which it appears, instead of remaining required. [Rod
Taylor]

=item *

Adding a new source to a group when you create it no longer causes an error.
Thanks to Alex Howarth for the spot! [David]

=item *

Changing an asset note and then going back to the notes screen before saving
the asset now properly shows the changed note instead of the old note.
Reported by Phillip Smith. [David]

=item *

New categories created via the SOAP interface with underscores in their URIs
no longer end up with backslashes in the URIs. Reported by Ashlee Caul.
[David]

=item *

Users attempting to access the "New Alias" link without permission to create
an alias will now be told so, instead of getting an error. Reported by
Marshall. [David]

=item *

Status messages now properly appear after saving or deleting a contributor
type. Reported by Marshall. [David]

=item *

The C<get_attr_hash()> method of
L<Bric::Util::Attribute|Bric::Util::Attribute> now excludes deleted attributes
from its return value. [David]

=back

=head1 VERSION 1.8.10 (2006-03-16)

=head2 Improvements

=over

=item *

Changed (hopefully optimized) the buffer size when reading in files on
media upload. [Scott]

=item *

The installer no longer prompts for the PostgreSQL system username if the
PostgreSQL server is not running on the local box. It therefore also no longer
becomes that user in such cases. This will simplify installing Bricolage onto
a remote PostgreSQL server. [David]

=item *

The Jobs manager now sorts pending jobs by scheduled time rather than name.
[David]

=item *

Desks now remember the sort order you selected when you last visited them, for
the duration of a single login to Bricolage. [David]

=item *

When adding contributors based on a type that allows multiple roles, you no
longer have to select the role if the contributor has only one role. Suggested
by Phillip Smith. [David]

=back

=head2 Bug Fixes

=over

=item *

Eliminated errors inserting array references fetched from image info while
uploading and saving new image files. Reported by Michael Holden. Also
documented extra methods not previously documented in
L<Bric::App::MediaFunc|Bric::App::MediaFunc>. [David]

=item *

Fixed typo in the final message after an upgrade completes. Reported by Nate
Perry-Thistle. [David]

=item *

Fixed a 1.8.9 upgrade script that adds a foreign key constraint to the
"element_member" table so that it properly tests for the foreign key
constraint before it tries to add it. Reported by Wayne Slavin. [David]

=item *

Refined a few other upgrade scripts, with thanks to Rod Taylor. [David]

=item *

L<Bric::Biz::Person::User|Bric::Biz::Person::User> loads again under
F<bric_queued>. [David]

=item *

The thumbnail-generating code now tries even harder to determine the media
type of a file, thus more likely supporting files that it might not have been
able to support before. [Rod Taylor]

=item *

F<bric_republish> no longer reverses the meaning of its C<--published-only>
option. [David]

=item *

Publishing via SOAP works again. It was broken in 1.8.9, where it would appear
to succeed, but no story or media would ever actually be distributed. [David]

=item *

Updated the Bricolage users list email address and archive link in
L<Bric::Admin|Bric::Admin>/F<INSTALL>. Reported by Michael Cummings [David]

=item *

Sort ordering on desks is no longer forgotten over multiple pages of assets on
a desk. Thanks to Phillip Smith for the spot! [David]

=item *

Changed the title of the Trail page from "Desk Stamps" to "Trail." Reported by
Scott. [David]

=item *

It is now possible to look up stories, media, and templates by version IDs
other than the current version ID. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.8.9 (2006-01-23)

=head2 Improvements

=over

=item *

Added missing foreign key constraints and indexes on the C<category_keyword>,
C<story_keyword>, C<media_keyword>, C<element_member>, and
C<media_contributor> tables. This should make keyword lookups, at least, much
faster. [David]

=item *

When a story or media document is published with an expiration date earlier
than the publish date, the UI will now properly report that the document has
been "expired", rather than "published". Thanks to Simon Wilcox for the spot.
[David]

=item *

The Bulk Publish interface in the UI now displays the name of the site
alongside the category if there is more than one site, so as to disambiguate
the list of categories. Reported by Marshall Roch. [David]

=item *

Added constraints to the story and media tables in the database to prevent the
publish status from becoming out of sync with the publish date and first
publish date. [David]

=item *

Changed code to show the first displayable data field of a subelement when
viewing or editing an asset as opposed to only text fields. [Paul Orrock]

=item *

L<Bric::SOAP::Workflow|Bric::SOAP::Workflow>'s publish method now schedules a
publish job instead of immediately publishing, thus allowing the
C<publish_date> parameter to actually work, and ensuring that the proper
version is published. [David]

=back

=head2 Bug Fixes

=over

=item *

Fixed misnamed and/or missing keyword foreign keys on the C<category_keyword>,
C<story_keyword>, and C<media_keyword> tables. [David]

=item *

Documents created or updated via SOAP will now set the publish date to the
same value as the first publish date if the latter is set and the former is
not. [David]

=item *

The Burner C<publish()> method now sets the publish date to the current date
and time if it was not specified via an argument. This will hopefully fix
instances of stories and media in the database with the C<first_publish_date>
set but not the C<publish_date>. [David]

=item *

The version 1.8.8 upgrade script that moves media files around no longer fails
when the media directory doesn't exist (because no media documents have been
created). Reported by Wayne Slavin. [David]

=item *

Upgrades no longer fail if $BRICOLAGE_ROOT is not set and the instance of
Bricolage to be upgraded is somewhere other than F</usr/local/bricolage>.
Reported by Nate Perry-Thistle. [David]

=item *

Backported database upgrade permissions changes from Bricolage 1.10 so that
the permissions are set for the super user for upgrade scripts such as
F<inst/upgrade/1.8.7/move_media.pl> and as the PostgreSQL user only when an
upgrade script loads F<inst/upgrade/lib/bric_upgrade.pm>. Thanks to Nate
Perry-Thistle for reporting the permissions bug with the 1.8.7 upgrade script.
[David]

=item *

Fixed file names for files uploaded by MSIE on Windows. Again. Reported by
Wayne Slavin. [David]

=item *

Modified the C<set_publish_status()> and C<set_published_version()> methods of
L<Bric::Biz::Asset::Business|Bric::Biz::Asset::Business> so that they each
make sure that the other is set. This will hopefully prevent only one from
being set. [David]

=item *

A media document that has a file uploaded to it before it is ever saved will
no longer cause it to store the media file in a directory without an ID
mapping it to the media document. This only affected installations where media
were created by some method other than the Bricolage UI or SOAP. Reported by
Rod Taylor. [David]

=item *

Story and Media on the search result page are now correctly sorted by the
"Default Asset Sort" preference, or title if the preference is not set. [Paul
Orrock]

=item *

Removed commented-out SQL that was appearing at the end of F<inst/Pg.sql>. The
comment style, C</* */>, caused problems with PostgreSQL 7.3 and earlier.
Reported by Jerry Franz, with the underlying problem identified by "aander07".
[David]

=item *

Media file names are now URI-escaped for inclusion in the URIs returned by
C<get_uri()> and C<get_primary_uri()>. Reported by Alexey Sheynuk. [David]

=item *

The burner now looks up existing resources (files) by both file system path
and URI, instead of just the file system path, since the combination of the
path and the URI are globally unique, not just the path. Reported by Paul
Hyland. [David]

=item *

Publishing a document with a related document, where the related document is
still at version 0 (because it has never been checked in), now properly
displays a message indicating that the related document cannot be published
because it is checked out. [David]

=item *

Removed testing code from the default F<book_review.mc> template on the file
system (not present in the template in the database) that was put in place
before the release of 1.8.6. [David]

=item *

Eliminated an error in the permissions screen when a site with workflows has
been deleted. Reported by Frank Febbraro. [David]

=item *

Fixed the "help on event logs" link in the Trail help page. Reported by Scott.
[David]

=item *

If a desk or My Workspace does not have assets of a particular type (stories,
media, or templates) on it, it will no longer display buttons for them.
Reported by Scott. [David]

=item *

Fixed the sorting menus for templates on desks. Also fixed them for all assets
on desks so that sorting on categories sorts by URIs (which are displayed)
rather than names. Template sorting issues reported by Scott. [David]

=item *

Adding a variable to the message in an alert type now properly triggers the
update of the message character count. Reported by Scott. [David]

=item *

Changed the media type for the files in the JavaScript directory from
"application/x-javascript", which Safari 2.03 didn't seem to like, to
"text/javascipt", which is what it should have been all along, anyway. [David]

=item *

Fixed sorting of SQL files for concatenation into F<inst/Pg.sql> so that it
should now always be in the right order, regardless of the local system's
locale settings. This issue only applied to those running C<make dist> or
C<make inst/Pg.sql>, since distributions already have F<inst/Pg.sql>. [David]

=item *

URIs are now always constructed with the cover date reflecting the global Time
Zone preference, rather than the setting from a user's overriding Time Zone
preference. This prevents URI conflicts and makes searches for URIs with dates
in them consistent. Reported by Li Li. [David]

=back

=head1 VERSION 1.8.8 (2005-10-27)

=head2 Bug Fixes

=over

=item *

Fixed thumbnail URIs broken in 1.8.7. [David]

=item *

Fixed the "media expire" event. [David]

=item *

Media documents with more than one file version are no longer expired as soon
as they're published. Reported by Wayne Slavin. [David]

=item *

Added upgrade script to adjust the file names of media files in the resource
table in the database to be in sync with the new names on the file system
introduced in 1.8.7. [David]

=back

##############################################################################

=head1 VERSION 1.8.7 (2005-10-24)

=head2 Improvements

=over

=item *

The installer now prefers typical installation paths over those in the
C<$PATH> environment variable when searching for Apache and PostgreSQL
installations. This is to favor servers installed manually over those included
with the operating system. [David]

=item *

Added a partial index on the C<comp_time> column of the job table so as to
speed up lookups of jobs yet to be completed. This was originally in a 1.6.7
upgrade script, but never made it into the SQL for new installations.
Suggested by Mark Jaroski. [David]

=item *

The Bulk Publish feature in the UI now only publishes the previously published
versions of unexpired stories and media, rather than the latest version of
expired and unexpired stories and media, thus avoiding errors when documents
are checked out. [David]

=item *

If a story passed to the C<publish_another()> or C<preview_another()> burner
methods is the same as the story currently being burned, it will no longer be
published or previewed again by C<publish_another()> or C<preview_another()>,
thus mitigating the possibility of infinite loops. [David]

=item *

Added an "Expired" event for when stories and media are expired. Suggested by
Joshua Edelstein. [David]

=back

=head2 Bug Fixes

=over

=item *

The Template Toolkit and HTML::Template burners work again. [David]

=item *

Fixed syntax error in Bric::Util::Trans::SFTP. Reported by Kenneth Marshall.
[David]

=item *

Eliminated "Subroutine Bric::App::Handler::rethrow_exception redefined"
warning during startup with HTML::Mason 1.30. [David]

=item *

Fixed the C<no_site_id> parameter to Bric::Biz::Asset::Formatting when
specified using the C<ANY()> function. [David]

=item *

Fixed an error in F<comp/widgets/wrappers/sharky/header.mc> caused by having a
custom field beginning with a leading underscore. [Scott]

=item *

Errors thrown when setting element field values will now be displayed as error
messages within the context of the element profile, rather than throwing a
fatal exception. This is useful for invalid dates, for example. [David]

=item *

The SOAP interface for categories now properly checks for and sets as
appropriate the C<active> attribute on categories being created or updated.
Reported by Phillip Smith. [David]

=item *

Updated for compatibility with PostgreSQL 8.1. [David]

=item *

Defunct media files are now properly removed from the delivery server whenever
a media document's file name has changed. Reported by Brad Fox. [David]

=item *

Clicking the "Return" button when viewing a subelement in a story or media
document not checked out by the user no longer drops into edit view. Reported
by John Greene. [David]

=item *

Attempting to create a category with the same URI as an existing but
deactivated category once again fails with a useful error message rather than
a database exception. Reported by Marshall. [David]

=item *

New elements and fields will now have any leading or trailing white space
trimmed, rather than converted to underscores. Reported by Scott Lanning.
[David]

=item *

Multiple select list custom fields no longer throw an exception when you
select more than one value for the default value. Reported by Scott. [David]

=item *

In a story or media profile, deleting a subelement with the same ID as a field
(or vice-versa) will no longer delete both. Reported by Scott Lanning. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.8.6 (2005-07-19)

=head2 Improvements

=over

=item *

Added JavaScript code to validate that the username in the user profile does
not have leading or trailing spaces. [David]

=item *

When started by the super user, F<bric_queued> now runs as the same user as
the Bricolage Apache server. This allows it to run as a user that isn't
otherwise available as a login on the system (such as the typical "nobody" or
"www" user). [David]

=item *

Added support for starting F<bric_queued> in the Linux startup script in
F<contrib/start_scripts/>. [David]

=item *

The C<get_related_story()> and get_related_media() methods of the element
class now return C<undef> in a list context when there is no related asset.
[David]

=item *

Events in the event log are now returned (and displayed) in reverse
chronological order. [David]

=item *

The SOAP server now uses a user's template sandbox when executing previews
(such as with C<bric_soap --to-preview workflow publish>). Reported by
Marshall. [David]

=item *

A job no longer throws an exception when it can't get a lock on itself for
execution. This is because the inability to get a lock may well be due to a
race condition with another process. There's no need to throw an exception
when it can't get a lock because another process has a lock. So it generates a
warning, instead. Reported by Bill Cappell. [David]

=item *

Bric::Biz::Workflow now caches calls to C<allowed_desks()>. This will allow
desks to render I<much> Faster, since most assets on a desk will list the same
desks in the "Move to" select lists. [David]

=item *

When the C<PUBLISH_RELATED_ASSETS> F<bricolage.conf> directive is enabled,
aliases are now also republished. Only aliases that have previously been
published will be republished, and only the last published version will be
republished, rather than any versions created since the last publish.
Suggested by Serge Sozonoff. [David]

=item *

Added the C<secret> parameter to the C<list()>, C<list_ids()>, and C<href()>
methods of Bric::Util::Grp. [David]

=item *

The C<set_page_extensions()> method of the burner class now provides a list of
duplicate extensions in the exception thrown when duplicate extensions are
passed to it. [Paul Orrock]

=item *

A story or media document published with an expire date earlier than the
scheduled publish time no longer bothers with the publish but just expires the
story or media document. [David]

=item *

When two events in a list have the same timestamp, they are no longer listed
in order by ID relative to each other, but relative to ID I<descending>, to
ensure that the one logged first will be listed after the one logged next.
[David]

=item *

Media documents without an associated media file will no longer be displayed
in the search results when attempting to relate a media document to an element.
Reported by Adam Rinehart. [David]

=item *

When a template is moved to a new category, its ACL is now properly updated in
the cached copy in the user's session, as well as in the database. [David]

=item *

Changed the C<published_version> parameter to the C<list()> method of
Bric::Biz::Asset::Template (the template class) to C<deployed_version>, but
kept C<published_version> as an alias.

=item *

Optimized C<path> and C<parent> searches in the Category C<list_ids> SOAP
method. [David]

=back

=head2 Bug Fixes

=over

=item *

The SOAP server now properly includes the start desk when it checks CREATE
permissions for creating stories, media, or templates. Reported by Alexandra
Gershman. [David]

=item *

Form validation and group management now properly work in the user profile.
[David]

=item *

Fixed the "story__category" table to use the correct sequence for the id
column's default value (although the default is never used, this is a good
precaution). Reported by Paul Orrock. [David]

=item *

Stories and media documents now better pay attention to the letter case
specification of output channels when returning URIs. Thanks to JosE<eacute>
Castro for the spot. [Marshall]

=item *

Stories now properly set the letter case of file names in URIs when
C<STORY_URI_WITH_FILENAME> is enabled. Reported by JosE<eacute> Castro.
[David]

=item *

The F<bricolage.conf> C<PERL_LOADER> directive now works properly with
F<bric_queued>. [David]

=item *

The SFTP mover now works with C<bric_queued>. [David]

=item *

Fixed misspelled database index name. Spotted by Scott. [David]

=item *

Error messages are now properly localized in C<bric_queued>. [David]

=item *

Stories updated via SOAP to change categories will no longer leave the old
categories associated with the story. [David]

=item *

Media uploads no longer sometimes fail with an SQL error. [Rod Taylor]

=item *

"All Types" now properly shows up at the top of the Types select list in the
Advanced Search. [Marshall]

=item *

Creating media with related stories via the SOAP interface will no longer
cause the bizarre "Could not find httpd.xml" error. Reported by Curtis Poe.
[David]

=item *

Removed possible circular processing of story and media documents when
creating new story or media documents via SOAP. [David]

=item *

Previewing and publishing multipage stories created through F<bric_soap> now
properly burn all of the pages. [Scott]

=item *

Cloned stories now properly set the C<published_version> attribute to C<undef>
rather than the value of the original story, thus preventing the clone from
having a published version number greater than its current version number.
Reported by Nate Perry-Thistle and Joshua Edelstein. [David and Nate
Perry-Thistle]

=item *

The F<bric_media_upload> contrib script now uses the site argument (if there
is one) to search for categories. This will prevent it from finding a category
in one site but not the upload target site. [David]

=item *

Fixed two bugs with C<bric_template_diff>. C<File::Spec::Functions> now
properly exports C<catfile()> and C<--from--site> and C<--to-site> now
properly search on the site rather than the output channel. [Ovid]

=item *

When a category is added to a story that creates a URI conflict, the new
category does not remain associated with the story in the story profile after
the conflict error has been thrown. Reported by Paul Orrock. [David]

=item *

The C<alias_id> parameter to the C<list()> method of the story and media
classes has been documented. [David]

=item *

Usernames are now SQL-escaped before being looked up when a user attempts to
log in. The prevents errors when, for example, there are two users named
"food" and "foo_", and "foo_" attempts to login and gets a failure. [David]

=item *

All calls to C<lookup()> methods by the SOAP server that pass string values to
look up (such as category URIs and site, workflow, and desk names) are SQL
escaped so as to prevent conflicts similar to those noted above for usernames.
Reported by Scott Lanning. [David]

=item *

Contributor groups created in the contributor profile are no longer missing
from the contributor manager search interface. Reported by Rachel Murray and
Scott. [David]

=item *

C<ANY()> now works properly for the C<output_channel_id> parameter to the
list() method of the story and media classes. Reported by Serge Sozonoff.
[David]

=item *

The F<favicon.ico> works again. [David]

=item *

Stories are now properly expired when the C<BRIC_QUEUED> F<bricolage.conf>
directive is enabled. Reported by Scott. [David]

=item *

When a template is checked out of the library and then the checkout is
canceled, it is no longer left on the desk it was moved into upon the
checkout, but properly reshelved. Reported by Marshall. [David]

=item *

Media created with the default "Image" and "Photograph" media type elements
will now properly supply a "Lock val" check box for autopopulated fields.
Reported by Marshall. [David]

=item *

Super Bulk Edit now works for media as well as stories. Reported by Scott.
[David]

=item *

The description attribute of stories, media, and templates is now properly
limited to 1024 characters in the UI. Reported by Scott. [David]

=item *

When a template is moved to a new category, the old version of the template is
undeployed when the new version is deployed to the new category. The versions
in the sandbox are properly synced, as well.

=item *

Eliminated a compile-time warnings from
F<contrib/bric_media_upload/bric_media_upload>. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.8.5 (2005-03-18)

=head2 Improvements

=over

=item *

Added the C<checked_in> parameter to the C<lookup()>, C<list()>, and
C<list_ids()> methods of the story, media, and template classes. If passed a
true value, this parameter causes the checked in version of the most current
version of the story to be returned. When a story is checked out, there are
two instances of the current version: the one checked in last, and the one
currently being edited. When the C<checked_in> parameter is a true value, then
the instance last checked in is returned, rather than the instance currently
checked out. This is useful for users who do not currently have a story
checked out and wish to see the story as of the last check in, rather than as
currently being worked on in the current checkout. If a story is not currently
checked out, this parameter has no effect.

=back

=head2 Bug Fixes

=over

=item *

Previews on non-checked out stories and media work again. [David]

=item *

Preview and views once again preview a story or media document as it was last
checked in, rather than as it might be currently being worked on in a current
checkout. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.8.4 (2005-03-18)

=head2 Improvements

=over

=item *

Made story profile's subelement 'Preview In' output-channel list consistent
with the top level one (e.g. editing a Page shows the same preview OCs as
editing the Story at the top level). [Scott]

=item *

Added Linux startup script F<contrib/start_scripts/linux>. [David]

=item *

Added C<version_id> parameter to the C<list()> methods of the story, media,
and template classes. Oversight reported by Kang-min Liu. [David]

=item *

Distribution via SFTP is now atomic and respects the C<FTP_UNLINK_BEFORE_MOVE>
directive. Spotted by Patrick Michael Kane. [David]

=item *

Related story and media elements managed through the SOAP server can now use a
combination of URI and site ID to identify related assets in addition to the
existing approach of using story and media IDs. [David]

=item *

Email sent by Bricolage now set the send date, since our understanding is
that the MUA is responsible for setting the date and some SPAM filters trigger
on missing Date: headers. [Cameron Miller]

=item *

The media type manager now validates media type names to ensure that they are
of the form "type/subtype" with no spaces. Suggested by Marshall Roch. [David]

=item *

When started up by the super user, the virtual FTP server now runs as the same
user as the Bricolage Apache server. This should prevent malicious users of
the virtual FTP server from being able to do things as the root user that they
shouldn't. [Keith Grennan]

=item *

SQL errors encountered when building the database are now fatal, meaning that
they will cause the entire installation to fail, rather than continuing to
execute SQL statements and build an incomplete database. This prevents the
creation broken databases when people didn't notice errors in the past.
[David]

=item *

A list of subelements is now less likely to mysteriously become out of order
and thus lead to strange action-at-a-distance errors. And even if they do
become out of order, the error message will be more appropriate ("Warning!
State inconsistent" instead of "Can't call method 'get_name' on an undefined
value"). Reported by Curtis Poe. [David]

=item *

Updated mail list information in L<Bric::Hacker|Bric::Hacker>. Reported by
Marshall Roch. [David]

=item *

The SOAP media interface now supports creating relationships between the media
documents elements and other story and media documents, just like the SOAP
story interface does. [David]

=item *

The SOAP interface now supports Related stories and media on story type and
media type elements just as in the UI. This involved the somewhat hackish
necessity for including the "related_story_id" and "related_media_id" (or
"related_story_uri" and "related_media_uri") attributes in the "elements" XML
element, but it does the trick. [David]

=item *

The list of elements to select from when creating a new template is now in
alphabetical order. [David]

=item *

The XML representation of media documents used by the SOAP server now supports
the media type of the file. [David]

=item *

The "multi" install destination is now the default, rather than the "single"
install destination. The two styles ("multi" and "single") are now also better
described during installation. [David]

=item *

When the installer prompts for database passwords, it no longer echoes them to
the terminal. Suggested by Marshall. [David]

=back

=head2 Bug Fixes

=over

=item *

Versions of Perl that disallow the use of the C<-I> argument in a setuid
environment will no longer cause the upgrade to fail. Reported by Serge
Sozonoff. [David]

=item *

The new support for a false value to the C<checked_out> parameter to the
C<list()> methods of the story, media, and template classes is now properly
supported by the SOAP C<list_ids> method, as well. [David]

=item *

Calls to publish documents via SOAP will no longer fail if the
C<published_version> attribute is not specified and the document to be
published has never been published before. [David]

=item *

The Bricolage virtual FTP server will no longer fail to start if Template
Toolkit is installed but its version number is less than 2.14. Reported by
Adam Rinehart. [David]

=item *

Fixed a bug where nothing would ever publish if you had
C<PUBLISH_RELATED_ASSETS> enabled in F<bricolage.conf>. [Mark]

=item *

Added "slug" to the list of attributes specified in the error message for a
non-unique URI in a story. Thanks to Rachel Murray for the spot! [David]

=item *

Fix in the SOAP server code to adjust for changes in Exception::Class 1.20.
[David]

=item *

Stories and Media created or updated via the SOAP interface will now associate
contributors of the appropriate type, instead of "All Contributors". [Scott &
David]

=item *

Deleting an element that has a template no longer causes an error. Thanks to
Susan for the spot! [David]

=item *

Eliminated encoding errors when using the SOAP interface to output stories,
media, or templates with wide characters. Reported by Scott Lanning. [David]

=item *

Fields with a an empty string or 0 (zero) for their values will no longer be
displayed as "Not defined" when viewing a story. [David]

=item *

Reverting (stories, media, templates) no longer gives an error. Reported by
Simon Wilcox, Rachel Murray, and others. [David]

=item *

Publishing a published version of a document that has a later version in
workflow will no longer cause that later version to be mysteriously removed
from workflow. This could be caused by passing a document looked up using the
C<published_version> to C<list()> to C<< $burner->publish_another >> in a
template. [David]

=item *

The SOAP server story and media interfaces now support elements that contain
both related stories and media, rather than one or the other. [David]

=item *

Attempting to preview a story or media document currently checked out to another
user no longer causes an error. Reported by Paul Orrock. [David]

=item *

Desk asset buttons are no longer broken in non-English localizations. Thanks
to Scott Lanning for the spot! [David]

=item *

Subelements will be properly deleted when selecting a "Delete" checkbox and
clicking "Save" or "Save and Stay" in the story or media profile. It always
worked in the element profile, and now it's consistent across document profile
interfaces. Spotted by Scott Lanning. [David]

=item *

Custom fields with default values now have their values included when they are
added to stories and media. Thanks to Clare Parkinson for the spot! [David]

=item *

The C<get_desk_stamps()> method in the asset classes has been deprecated (it
never worked, anyway) and will be removed in Bricolage 1.10.0. The same goes
for the C<required_satisfied()> method in Bric::Biz::Workflow. Thanks to
Marshall Roch for the spot! [David]

=item *

Subclasses of the media class no longer cause errors when distributing files
via C<bric_queued>. Thanks to Jason Edgecombe for the spot! [David]

=item *

Elements created via SOAP now correctly have site IDs associated with them.
[David]

=item *

The "All" alphabetical search now properly escapes the "%" wild card
character. Thanks to Frank Holtz for the spot! [David]

=item *

The C<bric_queued> script now requires a username and password and will
authenticate the user. This user will then be used for logging events. All
events logged when a job is run via the UI are now also logged by
C<bric_queued>. [Mark and David]

=item *

Jobs now get a "Job Created" event logged when they are created. Reported by
Rachel Murray. [David and Mark]

=item *

Eliminated "Use of uninitialized value in pattern match (m//)" warnings when
uploading media files. Reported by Scott Lanning. [David]

=item *

Preview redirections now use the protocol setting of the preview output
channel if it's available, and falls back on using "http://" when it's not,
instead of using the hard-coded "http://". Thanks to Martin Bacovsky for the
spot! [David]

=item *

The C<has_keyword()> method in the Business class (from which the story and
media classes inherit) now works. Thanks to Clare Parkinson for the spot!
[David]

=item *

Templates that abort during calls C<preview_another()> now properly abort
when not using C<PREVIEW_LOCAL>. [Paul Orrock]

=item *

Clicking a link in the left-side navigation after the session has expired now
causes the whole window to show the login form, rather than it showing inside
the nav frame, which was useless. [Marshall]

=item *

The names of media types (a.k.a. MIME types) can now be changed without
encountering an error. Thanks to Marshall Roch for the spot! [David]

=item *

Media type MIME Type names are now properly required in the UI. [David]

=item *

Fixed typo in the virtual FTP server which was causing an error when saving
a template. [Keith Grennan]

=item *

The JavaScript that validates form contents once again works with htmlArea,
provided htmlArea itself is patched. See
L<http://sourceforge.net/tracker/index.php?func=detail&aid=1155712&group_id=69750&atid=525656>
for the htmlArea patch. As of this writing, you must run the version of
htmlArea in CVS. [David & Marshall]

=item *

The JavaScript that handles the double list manager has been vastly optimized.
It should now be able to better handle large lists, such as a list of thousands
of categories. Reported by Scott. [Marshall]

=item *

Logging now works properly with the virtual FTP server. [Keith Grennan]

=item *

Some cases in which it was impossible to add actions to a destination have
been fixed. Reported by Marshall Roch. Thanks to Jason Edgecombe for making
available a server that exhibits the problem. [David]

=item *

The virtual FTP server no longer saves a template for every line in the
template when the FTP client uses ASCII mode. Thanks to Keith Grennan for the
spot! [David]

=item *

Reverting a template to a previous version now properly updates to the
reverted version on the user's sandbox. Also, canceling a checkout now
properly removes a template from a user's sandbox. [David]

=item *

When creating a new workflow, the workflow profile no longer forgets the
selected site when you click the "New Desk" button. [David]

=item *

Changing a template in such a way that it will be deployed to a new location
(by changing the category, for example) once again deletes the previous
version from the previous location when it is deployed. [David]

=item *

Uploading a new image to a media document with a different media type than the
previous image no longer causes an Imager error. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.8.3 (2004-11-09)

=head2 Improvements

=over

=item *

C<make clone> now ignores files in the source directory that start with
"bricolage-". This should prevent copying previous clones into the new
clone. [David]

=item *

Added F<contrib/thumbnails/precreate-thumbs.pl> script to pre-create
thumbnails from images. Useful for upgraders. [Scott]

=item *

Added primary key to the "event_attr", "element__site", "story_uri", and
"media_uri" tables in the database. This will make it easier to do database
replication. [David and Kenneth Marshall]

=item *

Added F<contrib/bric_import_contribs> to import contributors from a
tab-delimited file. Development by Kineticode, sponsored by the RAND
Corporation. [David]

=item *

Added the C<published_version> parameter to the C<list()> methods of the
story, media, and template classes. This parameter forces the search to return
the versions of the assets as they were last published, rather than the most
recent version. This will be most useful to those looking up other documents
in templates and publishing them, as a way of avoiding pulling documents out
from other anyone who might have them checked out! [David]

=item *

For those using the Template Toolkit burner, the required version is now 2.14,
so as to take advantage of the improved Unicode support in that version.
[David]

=item *

All publishing and distribution jobs are now executed in their own
transactions when they are triggered by the user interface. This is to reduce
the chances of a deadlock between long-running publishing transactions.
[David]

=item *

The installer now requires PostgreSQL 7.3 or later. This is because 7.2
hasn't worked properly with Bricolage since 1.8.0. [David]

=item *

Optimized SQL queries for key names or that order by string values to use
indexes in the C<list()> and C<list_ids()> methods of the story, media, and
template classes. [David]

=item *

The installer will now fail to install if the version of Apache is greater
than version 1--that is, it will refuse to install under Apache 2 (for now).
[David]

=item *

Added Russian localization. [Sergey Samoilenko].

=item *

Changed the foreign keys in the story, media, and formatting (template) tables
so that C<DELETE>s do not cascade, but are restricted. This means that before
deleting any source, element, site, workflow, or other related object that has
a foreign key reference in an asset table, those rows must be deleted.
Otherwise, PostgreSQL will throw an exception. Hopefully, this will put a stop
to the mysterious but very rare disappearance of stories from Bricolage.
[David]

=item *

The distribution monitor, F<bric_dist_mon>, no longer populates HTTP headers
with lists of Job IDs for execution. Instead, it simply sends a request to the
distribution handler, and Bric::Dist::Handler looks up the jobs to execute
itself. This fixes an issue with too many headers being put into the request,
and makes the operation of Bric::Dist::Handler more efficient. [David]

=item *

A call to C<< $burner->publish_another >> in a template that passes in a
date/time string in the future now causes a publish job to be scheduled for
that time, rather than immediate burning the document and then scheduling the
distribution to take place in the future. Reported by Ashlee Caul. [David]

=item *

Improved context-sensitive help for the "New Template" profile. [Paul Orrock
and David]

=item *

Make slug actually be required when C<ALLOW_SLUGLESS_NONFIXED> isn't enabled,
in particular on the clone page. Thanks to Dharmender Yadav at Enabling
Dimensions for part of the patch. [Scott]

=item *

Removed the hack that commits a database transaction in the middle of a
request that does a "Check in and Publish", since we now require PostgreSQL
7.3 and the bug that the hacked worked around was fixed in that release.
[David]

=item *

Added missing constraint to the "type" column of the "workflow" table. [David]

=item *

Changing the sort order of a list of items in a search interface now properly
reverses the entire collection of object over the pages, rather than just the
objects for the current page. Thanks to Marshall for the spot! [David]

=back

=head2 Bug Fixes

=over

=item *

The localization libraries load without error again. Added tests to ensure
that this doesn't happen again. [David]

=item *

Publishing stories not in workflow via the SOAP server works again. [David]

=item *

Documents that the SOAP workflow publish finds in workflow but not on a desk
(which shouldn't happen, but sometimes does) are now just published anyway.
[David]

=item *

The Burner object's C<encoding> attribute is now setable as well as readable.
[David]

=item *

The category browser works again. [David]

=item *

Fixed the "event" table to use the correct sequence the for they id column's
default value (although the default is never used, this is a good precaution).
[David]

=item *

Fixed Media Upload bug where the full local path was being used, by adding
a 'winxp' key to Bric::Util::Trans::FS to account for an update to
HTTP::BrowserDetect. [Mark Kennedy]

=item *

A call to C<< $element->get_elements >> in an array context when the element
contains no subelements no longer returns an array reference. Reported by
Clinton Gormley. [David]

=item *

Fix bug 839 so that categories can be deleted. [Scott]

=item *

Instances of a required custom field in story elements is no longer required
once it has been deleted from the element definition in the element manager.
Reported by Rod Taylor. [David]

=item *

A false value passed to the C<checked_out> parameter of the C<list()> and
C<list_ids()> methods of the story, media, and template (formatting) classes
now properly returns only objects or IDs for assets that are not checked out.
[David]

=item *

The cover date select widget now works properly in the clone interface when a
non-ISO style date preference is selected. Thanks to Susan G. for the spot!
[David]

=item *

By forcing the upgrade scripts to execute as the PostgreSQL user, running
C<make upgrade> with PostgreSQL "ident sameuser" security now works properly.
[Keith Grennan]

=item *

The C<LoadModule> and C<AddModule> F<httpd.conf> directives should now be
generated properly during installation. C<LoadModule> will use
C<config_log_module> or C<mod_log_config> depending on the system, but
C<AddModule> will always use F<mod_log_config.c>. Spotted by Dave
Jablonski. [Marshall]

=item *

Deleted sites will no longer be displayed in the site context menu in the
UI. Reported by Ed Stevenson. [David]

=item *

Sorting templates based on Asset Type (Element) no longer causes an error.
[David]

=item *

Events are now logged during the cleanup phase in alphabetical order by event
type key name, to prevent deadlocks between two transactions logging events of
the same types in different orders at the same time. [David]

=item *

Fixed a number of the callbacks in the story, media, and template profiles so
that they didn't clear out the session before other callbacks were done with
it. Most often seen as the error 'Can't call method "get_tiles" on an
undefined value' in the media profile, especially with IE/Windows (for some
unknown reason). Reported by Ed Stevenson. [David]

=item *

Fixed typo in clone page that caused all output channels to be listed
rather than only those associated with the element itself. [Scott]

=item *

Fixed double listing of the "All" group in the group membership double list
manager. [Christian Hauser]

=item *

Mail sent for alerts and the like now has DOS and Macintosh line-endings
converted to Unix so that they are displayed properly in most mail clients.
[Christian Hauser and David]

=item *

Documented required C<user__id> parameter to the C<new()> method in the story
and media classes. Reported by Rod Taylor. [David]

=item *

Image buttons now correctly execute the C<onsubmit()> method for forms that
define an C<onsubmit> attribute. This means that, among other things, changes
to a group profile will persist when you click the "Permissions" button.
[David]

=item *

Media type groups now properly display their members.

=item *

The "Edit" link that showed up for categories associated with a story when the
C<ENABLE_CATEGORY_BROWSER> F<bricolage.conf> directive has been removed. It
didn't belong there in the first place. Reported by Ho Yin Au. [David]

=item *

Simple search now works when it is selected when the "Default Search"
preference is set to "Advanced". Reported by Marshall Roch. [David]

=item *

Multiple alert types set up to trigger alerts for the same event will now all
properly execute. Thanks to Christian Hauser for the spot! [David]

=item *

Publishing stories or media via SOAP with the C<published_only> parameter
(C<--published-only> for F<bric_republish>) now correctly republishes the
published versions of documents even if the current version is in workflow.
Reported by Adam Rinehart. [David]

=item *

Added upgrade script to clean out old records left in the "member" table if
users elected to delete old jobs during the 1.8.2 upgrade. [David]

=item *

Users granted a permission greater than READ to the members of the "All Users"
group no longer get such permission to any members of the "Global Admins"
group unless they have specifically been granted such permission to the
members of the "Global Admins" group. Thanks to Marshall Roch for the spot!
[David]

=back

=cut

##############################################################################

=head1 VERSION 1.8.2 (2004-11-13)

=head2 Improvements

=over

=item *

Added note to the context-sensitive help for the story, media, and template
search pages to search on "/" to return all records, and to use SQL wildcards
such as "%" to generalize the search. [David]

=item *

C<make upgrade> no longer copies the entire installed component root to a new
directory as a way to get rid of old UI component files. We now require that
any deleted component files get removed from an existing installation via an
upgrade script, instead. See F<inst/upgrade/1.7.0/delete_old_components.pl>
for an example. [David]

=item *

Bricolage now runs under a DSO C<mod_perl> as long as it uses a Perl compiled
with C<-Uusemymalloc> I<or> C<-Ubincompat5005>. See
L<http://perl.apache.org/docs/1.0/guide/install.html#When_DSO_can_be_Used> for
details. Thanks to Marshall Roch for finding that link. [David]

=item *

The New Story and New Media profiles by default no longer have a value
selected for the Story Type or Media type (respectively), so as to prevent
the inadvertent creation of documents of the wrong type. [David]

=item *

Alerts triggered to be sent to users who don't have the appropriate contact
information will now be logged for those users so that they can see them and
acknowledge them under "My Alerts". [David]

=item *

Added F<bric_media_dump> script to F<contrib/>. [David]

=item *

The category association interface used in the story profile when the
C<ENABLE_CATEGORY_BROWSER> F<bricolage.conf> directive is enabled now uses
radio buttons instead of a link to select the primary category. Suggested by
Scott Lanning. [David]

=item *

Search by site is now supported in the "Advanced Search" interface of "Find
Stories", "Find Media", and "Find Templates" when there is more than one site
and the "Filter by Site Context" preference is not turned on. [David]

=item *

Removed Bric::FAQ, since it is now maintained on the Website, instead. [David]

=item *

Updated Bric::Admin to suggest that PostgreSQL's C<initdb> be run with
C<--no-locale> so as to avoid collation issues with non-Western characters.
See this discussion for more information:
L<http://archives.postgresql.org/pgsql-general/2004-08/threads.php#01079>

=item *

Added a warning to the story and media profiles for when related stories and
media have been deactivated and a different story or media document should be
related.

=item *

Added output to the Apache log consisting of the 20 most recent events on an
asset that has lost track of what workflow and/or desk it is on. This is to
provide debugging information that might help us to track down when an asset
forgets its workflow and/or desk, so that we might eventually be able to
eliminate the code that picks up on this and corrects it. [David]

=item *

The distribution monitor, F<bric_dist_mon>, now prints error information to
C<STDERR> when there is an error, instead of just printing it to the system
log. [David]

=item *

Existing jobs are now executed within their own transactions, as opposed to no
transaction specification. This means that each job must succeed or fail
independent of any other jobs. New jobs are executed before being inserted
into the database so as to keep them atomic within their surrounding
transaction (generally a UI request). All this means that transactionality is
much more intelligent for jobs and will hopefully eliminate job table
deadlocks. Reported by Mark Jaroski, Serge Sozonoff, Patrick Michael Kane, and
others. [David]

=item *

The workflow, destination, and output channel profiles only display site
information if the user has EDIT access to more than one site. The "Find
Stories" and "Find Media" managers only display the site information for the
listed documents if there is more than one site in Bricolage. Suggested by
Scott Lanning. [David]

=item *

Updated documentation of parameters to the C<list()> method of
Bric::Biz::Asset::Template (the template class). Also documented a few
parameters to the story and media class C<list()> methods that were supported
but previously undocumented. [David]

=item *

Variables are now properly decoded to UTF-8 when they are populated from the
database. [David]

=item *

The strings used in translations are now all properly decoded to UTF-8.
[David]

=item *

All templates now execute with UTF-8 character strings enabled. This means
that any templates that convert content to other character sets might need to
change the way they do so. For example, templates that had used
C<< <%filter> >> blocks to convert content to another encoding using something
like C<Encode::from_to($_, 'utf-8', $encoding)> must now use something like
C<$_ = Encode::encode($encoding, $_)>, instead. Bric::Util::CharTrans should
continue to do the right thing. [David]

=item *

Added C<encoding> attribute to Bric::Util::Burner so that, if templates are
outputting something other than Perl C<utf8> decoded data, they can specify
what they're outputting, and the file opened for output from the templates
will be set to the proper mode. Applies to Perl 5.8.0 and later only. [David]

=item *

Added example use for C<< $burner->display_pages >> to Bric::AdvTemplates.
[Cinly Ooi]

=item *

Added F<README.Mandrake>. [Cameron Miller]

=item *

Added C<SFTP_HOME> F<bricolage.conf> directive to specify the home directory
and location of SSH keys when SSH is enabled. [Cameron Miller]

=item *

Users can no longer implicitly publish related stories and media via the UI
that they don't have PUBLISH access to. [David]

=item *

Users can no longer publish related documents via the UI or SOAP that are in
workflow but not on a publish desk. [David]

=item *

Added search by output channel to "Find Templates". [David]

=item *

Previewing a document with a related media document that's checked out no
longer triggers a "Cannot auto-publish related media because it is checked
out" message. [David]

=back

=head2 Bug Fixes

=over

=item *

The burner C<next_page_file()> and C<next_page_uri()> methods now properly
return a value if the C<burn_again> attribute has been set to a true value in
the Mason burner. [David]

=item *

The C<list()> and C<list_ids()> methods of the story, media, and template
classes no longer return C<undef> in a scalar context when there are no
objects to be returned. They return an empty array reference, instead. [David]

=item *

The C<is_fixed()> method in the story and media classes now works properly.
Reported by Marshall Roch. [David]

=item *

C<make clone> once again properly copies the F<lib/Makefile.PL> and
F<bin/Makefile.PL> files from the source directory. [David]

=item *

Fixed the C<my_meths()> method of Bric::Biz::AssetType::Parts::Data to return
metadata for the the C<key_name> attribute instead of an C<undef> for the
removed C<name> attribute. [Scott]

=item *

Added missing language-specifying HTML attributes so as to properly localize
story titles and the like. Reported by Joshua Edelstein. [David]

=item *

The list of output channels to add to an element in the element profile now
contains the name of the site that each is associated with, since different
sites can have output channels with the same names. [David]

=item *

You can no longer delete a category from a story when you have also marked it
to become the primary category. Reported by Simon Wilcox. [David]

=item *

Editing notes from My Workspace now works properly. Thanks to Simon Wilcox for
the spot! [David]

=item *

The "Advanced Search" interface once again works for searching for related
story and media documents. Reported by Ben Bangert and many others. [David]

=item *

Renaming a site and its domain name now always properly renames the associated
site permission user groups. Reported by Will Trillich. [David]

=item *

The "Alias Story" interface now works properly when the C<USE_THUMBNAILS>
directive is enabled. Reported by Ben Bangert. [David]

=item *

Attempting to create a new source with the same name as an existing but
deactivated source no longer throws an SQL error, but provides a nice error
message. Reported by Marshall Roch. [David]

=item *

Bricolage no longer attempts to email alerts to an empty list of recipients.
This will make your SMTP server happier. [David]

=item *

The version numbering issues of Bricolage modules have all been worked out
after the confusion in 1.8.1. This incidentally allows the HTML::Template and
Template Toolkit burners to be available again. Reported by Mike W. [David]

=item *

Misspelling the name of a key name tag or including a non-repeatable field
more than once in Super Bulk Edit no longer causes all of the changes in that
screen to be lost. [David]

=item *

When a user overrides the global "Date/Time Format" and "Time Zone"
preferences, the affects of the overrides are now properly reflected in the
UI. [David]

=item *

The "Default Asset Sort" preference now actually works. Reported by Simon
Wilcox. [David]

=item *

Publishing a story or media document along with its related story or media
documents from a publish desk again correctly publishes the original asset as
well as the relateds. Reported by Paul Orrock. [David]

=item *

Users can now set their own values for overrideable preferences. [David]

=item *

The C<list()> and C<list_ids()> methods of the Story, Media, and Template
(F<Template.pm>) classes no longer have the side effect of changing values
in the hash references passed to them. This had caused problems for date/time
parameters. Reported by Paul Orrock. [David]

=item *

Auto-generated slugs (enabled via the C<AUTOGENERATE_SLUG> F<bricolage.conf>
directive) no longer convert uppercase characters to underscores. Thanks to
Paul Orrock for the spot! [David]

=item *

Changes made to story content in the story profile are no longer preserved
when clicking the "Cancel" button. Reported by Paul Orrock. [David]

=item *

The story and media profiles now clear out the session cache for the story or
media element when leaving the story or media profile. This is to prevent
perceived caching of changes that were canceled in a profile, noticed only
when one canceled an edit of a story or media document and immediately edited
the same document. [David]

=item *

Clicking the "Add More" button to add more keywords to a new category no
longer causes an error. [David]

=item *

Adding a new category to a group and asking it to cascade that group
membership into subcategories no longer causes an error. Thanks to Adam
Rinehart for the spot! [David]

=item *

Adding an existing publish desk to a workflow no longer unsets its publish
attribute. [David]

=item *

Deleted output channels no longer show up in the select list for story type
and media type elements. [David]

=item *

Deleting a workflow from the workflow manager now properly updates the
workflow cache so that the deleted workflow is removed from the left
navigation without a reboot. [David]

=item *

Creating a story, checking it in, checking it out, and then canceling the
checkout no longer incorrectly removes the story from workflow. [David]

=item *

The source of a story can now be changed. [David]

=item *

Status messages sent to the browser during previews are now hidden if an error
is triggered. [Marshall]

=item *

Publishing a document with deactivated related documents no longer causes
those deactivated documents to be published, too. Reported by Paul Orrock.
[David]

=item *

The Bricolage 404, 403, and 500 error pages now send the appropriate HTTP
header to the browser. Thanks to Marshall Roch for the spot! [David]

=item *

The Output Channel URI Prefix and URI Suffix fields are once again allowed to
include a slash (F</>). Reported by Kevin Elliott. [David]

=item *

An attempt to create a new template with the proper extension as part of the
name (e.g., F<foo.mc> for a Mason template) now keeps the extension instead of
changing the dot to an underscore and adding the extension (e.g., it stays
F<foo.mc> instead of becoming F<foo_mc.mc>). This is especially useful when
creating utility templates and for users of C<bric_dev_sync>. Thanks to Paul
Orrock for the spot! [David]

=item *

When Bricolage notices that a document or template is not in workflow or on a
desk when it should be, it is now more intelligent in trying to select the
correct workflow and/or desk to put it on, based on current workflow context
and user permissions. Reported by Hal Creech. [David]

=item *

Content submitted to Bricolage in the UTF-8 character set is now always has
the C<utf8> flag set on the Perl strings that store it. This allows fields
that have a maximum length to be truncated to that length in characters
instead of bytes. Thanks to Kang-min Liu for the spot! [David]

=item *

C<< Bric::Biz::OutputChannel->list_ids >> no longer returns duplicate
IDs. This incidentally allows output channels that happen to be in groups to
be edited, eliminating the 'name "Web" is already used by another Output
Channel' error. Thanks to John Greene for the spot! [David]

=item *

The media type of media documents now defaults to "none" instead of inserting
a C<NULL> into the database. The column has also be marked C<NOT NULL> in
order to ensure that this remains the pattern. [David]

=item *

Changed the "name" and "error_message" columns in the "job" table in the
database from C<VARCHAR> to <TEXT>. This is so that we don't have to truncate
them before inserting them. [David]

=item *

Elements with autopopulated fields (e.g., for image documents) can now be
created via the SOAP interface. Reported by Todd Tyree. [David]

=item *

Fixed a number of the parameters to the C<list()> method of the Story, Media,
and Template classes to properly handle an argument using the C<ANY>
operator. These include the C<keyword> and C<category_uri> parameters. Passing
an C<ANY> argument to these parameters before this release could cause a
well-populated database to lock up with an impossible query for hours at a
time. [David]

=item *

Restored foreign keys and constraints missing on the "job" table and related
tables since version 1.8.0. [David]

=item *

The error message for failed distribution jobs is now properly displayed in
the UI. [Mark]

=item *

Fixed bug with the execution of jobs in F<bric_queued>. [Mark]

=item *

Attempting to create a new desk with the same name as a deactivated desk
no longer returns an SQL error, but a more informative error.

=item *

Template sandboxes now work for the Template Toolkit burner. [David]

=item *

The output channel and element profiles no longer display deactivated output
channels in their output channel select lists (for output channel includes in
the output channel profile and for primary output channels in the element
profile). [David]

=item *

The side navigation layer now works correctly with Internet Explorer 5.5 for
Windows. [Marshall]

=back

=cut

##############################################################################

=head1 VERSION 1.8.1 (2004-07-08)

=head2 Improvements

=over

=item *

More complete Traditional Chinese and Simplified Chinese localizations. Also,
the Mandarin localization now simply inherits from the Traditional Chinese
localization. [Kang-min Liu]

=item *

C<make clone> now copies the F<lib> directory and all of the F<bin> scripts
from the target to the clone, rather than from the sources. This allows any
changes that have been made to scripts and classes to be properly cloned.
[David]

=item *

When installing Bricolage, it will now allow you to proceed if the database
already exists by asking if you want to create the Bricolage tables in the
existing database. Suggested by Mark Fournier and Marshall Roch. [David]

=item *

Added some missing translations for English. [David]

=item *

The installer is now a bit smarter in how it handles loading the C<log_config>
(or C<config_log>, as the case may be) module. [Marshall Roch]

=item *

Added ID attributes to story, media, and element profiles and "fieldcontent"
class to content field values in the "View" screens so that they can be
used as CSS selectors. [David]

=item *

Added language-specific style sheets. This is especially useful for
right-to-left languages or for languages that require special fonts. [David]

=item *

The "New Alias" search interface now displays thumbnails when searching for
media documents to alias and the C<USE_THUMBNAILS> F<bricolage.conf> directive
is enabled. Reported by Serge Sozonoff. [David]

=item *

The C<has_member()> method of Bric::Util::Grp is now faster when searching for
a specific group member. [David]

=item *

Aliases can now be made to documents within the same site. [Serge Sozonoff]

=item *

When viewing the contents of a document, the contents now have their HTML
escaped. This prevents any broken HTML in the content from breaking the
Bricolage UI. Suggested by Neal Sofge. [David]

=item *

The SOAP interface for importing and exporting elements now properly has
"key_name" XML elements instead of "name" XML elements. The changes are
backwards compatible with XML exported from Bricolage 1.8.0 servers, however.
Reported by Tony Cowderoy. [David]

=item *

Added C<move()> method to the virtual FTP interface. This means that to deploy
a template, rather than having to rename it locally to append ".deploy", one
can simply move in FTP to its new name with ".deploy" on appended to the new
name. [JoE<atilde>o Pedro]

=item *

Document expirations are now somewhat more intelligent. Rather than just
scheduling an expiration job only if there is an expiration date the first
time a document is published, Bricolage will now always schedule an expiration
job for a document provided that one does not already exist (scheduled or
completed) for the same time and for one of the file resources for the
document. This should allow people to more easily and arbitrarily expire
content whenever necessary. Thanks to John Greene for the discussion that
finally motivated this change. [David]

=item *

Improved zh-cn translation. [Gang Luo]

=item *

Burner notes now persist for all sub burns (triggered by C<publish_another()>
and C<preview_another()> in a single burn. [Serge Sozonoff]

=item *

Keyword groups now properly display their members. [David]

=item *

Added ability to create and manage groups of objects for several different
types of objects. Also added the ability manage group membership within the
administrative profiles for those objects. This change makes it possible to
give users permission to administer subsets of objects. The new groupable
objects are:

=over

=item Preferences

=item Groups

=item Alert Types

=item Element Types

=item Keywords

=item Contributors

=back

[David]

=item *

Alert rules are now evaluated within a safe compartment (using Safe.pm) to
prevent security exploits. [David]

=item *

The Bulk Publish admin tool is no longer limited to use only by members of the
Global Admins group. Now anyone can use it. All one needs is READ permission
to the categories of stories, and PUBLISH permission to the stories and media
documents to be published. [David]

=back

=head2 Bug Fixes

=over

=item *

Bulk Publish now ensures that users have at least READ access to categories
they wish to publish from. [Scott]

=item *

Eliminated 'Bareword "ENABLE_HTMLAREA" not allowed while "strict subs" in use'
warning that prevented startup for some installations. [Scott]

=item *

The Mason burner now appends a "/" to the end of the category path it
specifies for burning a story. This removes the ambiguity between a directory
request and a file request, which in rare circumstances could cause unexpected
problems. [David]

=item *

Changes made to user or contributor contacts without changing any other part
of the user or contributor object are now properly saved. [David]

=item *

When cloning a story, the list of output channels to select from is now
limited to the site the current workflow is in. Thanks to Serge Sozonoff for
the spot! [David]

=item *

Attempting to publish a story or media document with brackets in the title no
longer causes an error. Reported by Serge Sozonoff. [David]

=item *

Fixed a F<bric_soap> C<list_ids> bug [712] with the C<no_workflow> option.
[Clive Jones]

=item *

The upgrade to 1.8.0 now correctly updates story URIs that use the URI Suffix
of an output channel instead of using the URI Prefix twice. [John Greene]

=item *

The Advanced Search interface for stories and media now displays only the
top-level elements associated with the site the workflow is in when searching
for stories and media "By Type". [David]

=item *

Improved error logging for more recent versions of Apache, which unfortunately
escape newlines. [David]

=item *

When Bricolage discovers a document or template on a desk but not in a
workflow, it now places it in a workflows associated with the same site as the
document or template is associated with. Thanks to Serge Sozonoff for the
spot! [David]

=item *

Aliases of Image, Audio, or Video media documents no longer remain stuck on
desks. Reported by Serge Sozonoff. [David]

=item *

Related media and story subelements of media documents now work properly.
Thanks to Kang-min Liu for the spot! [David]

=item *

The distribution and SOAP handlers now load a localization object so that any
code that uses localization will work properly. Reported by Clive Jones.
[David]

=item *

The C<set_page_extensions()> method of Bric::Util::Burner now throws an
exception if duplicate page extensions are passed, rather than deferring the
exception to the creation of a distribution job, which was confusing. [Clive
Jones]

=item *

Calls to C<preview_another()> in Bric::Util::Burner will now use any templates
in the current user's sandbox and properly burn them to the preview root
rather than to the staging root used for publishing. Reported by Serge
Sozonoff. [David]

=item *

Contributor fields for roles other than the default role now properly store
and retain their values. [David]

=item *

The virtual FTP server now properly checks out templates when a template is
uploaded and is already in workflow.

=item *

Uploading a non-existent template via the virtual FTP server now correctly
creates a new template. The type of template depends on the name of the
template being uploaded, and for element templates, on whether there is an
element with the appropriate key name. The user must have CREATE permission
to All Templates or to the start desk in the first template workflow in the
relevant site.

=item *

Reverting a document or template to the current version number now properly
reverts all changes to the time the user checked out the document or
template. Reversion is also a bit more efficient in how it looks up the
previous version in the database. [David]

=item *

The SOAP server now rolls back any changes whenever an error is thrown. This
prevents problems when a few objects are created or updated before an
exception is thrown. Now any error will cause the entire SOAP request to
fail. Thanks to Neal Sofge for the spot! [David]

=item *

Changing the "Size" display attribute of a field in the Field profile (a
subprofile of the Element admin profile) now properly causes the field to
actually display in the new size. Reported by Tony Cowderoy. [David]

=item *

The table of contacts in the alert type profile is now more like other tables,
in terms of border colors, etc. [David]

=item *

The Bulk Publish admin tool now only limits the category search to the current
site context if the "Filter by Site Context" preference is checked. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.8.0 "Portland" (2004-05-03)

=head2 Improvements

=over

=item *

The F<inst/upgrade/1.7.0/data_tile_key_name.pl> upgrade script now skips
upgrading "key_name" if it would be no different than "name". This can save a
lot of time during upgrade if your database is large. [Scott]

=item *

For checked-out media, stories, and documents listed in the "Active" and
"Find" interfaces, added the name of the user who has each checked out to the
empty column that would otherwise contain a "Checkout" checkbox. [David]

=item *

Keyword names are now always editable in the keyword manager. [David]

=item *

Added UI for managing organizations, which provide the base data for souces.
[David]

=item *

HTML, CSS, and JavaScript fixes that allow Bricolage to work properly with
most browsers, including Safari 1.2.1, IE 5.2/Mac, Konqueror, Opera 7, and
many others. [Marshall Roch]

=item *

Added stubs for zh-hk localization. [David]

=item *

Added missing localizations to the Language preference. Many of these are not
yet translated, but there they are. [David]

=item *

Selecting a checkbox to delete an output channel in a story or media profile
and then clicking a button other than the output channel "Delete" button or
the "Save" or "Save and Stay" buttons no longer causes an error. Reported by
Delfim Machado. [David]

=item *

If the "Select All" button is clicked to select all the checkboxes on a desk,
and then is clicked again, it will uncheck all of the check boxes. [David]

=item *

Login redirection now works properly with Safari. [David]

=item *

The installation script now provides more information (and questions) when it
attempts to create a database user that already exists. Suggested by Marshall
Roch. [David]

=back

=head2 Bug Fixes

=over

=item *

Added a missing space to the breadcrumb in the header. [Marshall Roch]

=item *

The new C<SFTP_MOVER_CIPHER> F<bricolage.conf> directive now actually works.
[David]

=item *

The group profile works again for element groups [David]

=item *

"Check In To" link misalignment fixed for Konqueror, as well as some other
miscellaneous CSS fixes. [Marshall Roch]

=item *

The "CREATE" permission is now displayed when granting permission to user
groups to access the members an "All" group. [David]

=item *

The "none" media type is no longer editable via the UI. [David]

=item *

Invalid story cover and expire dates now properly trigger an error message.
[David]

=item *

Deactivated keywords are no longer returned by the C<get_keywords()> methods
of the Business asset class (from which Story and Media inherit) or the
Category class. Reported by Paul Orrock. [David]

=item *

Events are now properly logged for keywords managed in the keyword profile.
[David]

=item *

Media URIs are now properly updated when the primary output channel is changed.
Reported by Ben Bangert. [David]

=item *

Bulk publish no longer marks checked-out stories as published when it hasn't
published them. It also is no longer redundant when it reports that
checked-out assets won't be published. Thanks to Serge Sozonoff for the spot!
[David]

=item *

Safari users will no longer be stuck on the login page. [David]

=item *

The CSS directory now has its files always served as "text/css". This should
eliminate problems when Apache sometimes serves the CSS files as "text/html".
[David]

=item *

The C<desk_id> parameter to the C<list()> methods of the story, media, and
template classes now works. [JoE<atilde>o Pedro]

=item *

Stories published via the "Checkin and Publish" select list in the story
profile now correctly publish related stories and media. Reported by
JoE<atilde>o Pedro. [David]

=item *

Stories and media are no longer published twice when published from a publish
desk or via Bulk Publish. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.7.5 "Ashland" (2004-04-11)

=head2 New Features

=over

=item *

Added F<bric_template_dump> to F<contrib>. This script uses the Bricolage SOAP
server to export all of the templates in a single output channel. [David]

=item *

Added C<SFTP_MOVER_CIPHER> F<bricolage.conf> directive to tune the SFTP mover
(if enabled) to the best cipher for good performance on the wire. [David]

=back

=head2 Improvements

=over

=item *

Added site and output channel support to F<bric_template_diff> and
F<bric_template_patch> in F<contrib>. [David]

=item *

When cloning a story, you can now select a new primary output channel, in
addition to category, slug, cover date, etc. Suggested by Serge Sozonoff.
[David]

=item *

Spell checking now works in HTMLArea. [Eric Sellers]

=item *

When creating a new story without a slug, Bricolage will now autogenerate
a slug based on the title. [JoE<atilde>o Pedro]

=item *

Added single underscore parameters to the C<list()> methods of the Story,
Media, and Template classes to complement those that have the awful double
underscores. [David]

=item *

Made SOAP modules more tolerant of lack of sites in 1.6. [Scott]

=item *

The collection API now checks newly added members when deleting members. This
ensures that newly added objects won't be saved to the database if they are
deleted, first. [David]

=item *

Turned off browser autocompletion in the Server and User profiles. This
prevents some browsers (e.g., Camino) from filling in your username and
password where it doesn't belong. [David]

=item *

When the "Filter by Site Context" preference is enabled, it no longer filters
documents when searching for documents to alias. Reported by Patrick Walsh.
[David]

=item *

The "Cancel Checkout" button in the Story, Media, and Template profiles now
tries to do the right thing instead of just leaving the asset on a desk in
workfow every time. If the asset was just created by the user, it will be
deleted. If it was just recalled from the library by the user, it will be
removed from workflow and shelved in the library. Otherwise, clicking the
"Cancel Checkout" button will leave the asset in workflow. Requested by Sara
Wood, Rachel Murray, and others. [David]

C<make clone> now provides the current date and time for the default name for
the cloned package. Suggested by Marshall Roch. [David]

=back

=head2 Bug Fixes

=over

=item *

Bricolage no longer tries to display thumbnails for related stories, since
stories don't have thumbnails and would therefore create an error. [Eric
Sellers]

=item *

Text::Levenshtein is again correctly loaded as an optional module, not a
required module. Reported by Marshall Roch. [David]

=item *

Bric::Util::Burner's C<preview_another()> method now actually works. Thanks to
Serge Sozonoff for the spot. [David]

=item *

Fixed clone interface for IE users. Spotted by Serge Sozonoff. [Scott]

=item *

Some of the supported values for the C<Order> parameter to the Story, Media,
and Template classes, such as C<category_uri>, did not work before. Now they
do. [David]

=item *

Changing categories on a template no longer creates Frankensteinian template
paths. [David]

=item *

Added constant C<HAS_MULTISITE> to the Bric base classe so that all classes
properly declare themselves for UI search results. [JoE<atilde>o Pedro]

=item *

Story and Media SOAP calls now correctly use the element's key name to
identify the element. [JoE<atilde>o Pedro]

=item *

Story, Media, and Template creation via SOAP now correctly look up the
Category by URI and site ID. [JoE<atilde>o Pedro & David]

=item *

The Template SOAP interface now suports the C<site> parameter to
C<list_ids()>. [David]

=item *

The Story, Template, and Media SOAP C<list_ids()> intefaces now properly look
up categories, output channels, and workflows with the C<site> paremeter, if
there is one. [David]

=item *

The C<LOAD_LANGUGES> and C<LOAD_CHAR_SETS> directives are now space delimited,
to better match other F<bricolage.conf> options. [David]

=item *

Aliased media documents now correctly point to the file name for the aliased
media document. Reported by Patrick Walsh. [David]

=item *

Thanks to the improvements to the collection class, cloning stories and
putting them into new output channels to ensure that they have unique URIs now
works properly. Reported by Serge Sozonoff. [David]

=item *

The publish status and version is once again properly set for media when they
are published. Reported by Serge Sozonoff. [David]

=item *

The group manager now properly displays the names of the sites that member
objects are associated with if the class of the objects being managed knows
that its objects are associated with sites. Reported by Ho Yin Au. [David]

=item *

The list of output channels to add to a media or story document in the media
and story profiles now includes only those output channels associated with the
site that the story or media document is in. [David]

=item *

Thanks to the fix to 1.6.13 that prevents deleted groups from affecting
permissions, there is no longer any need to provide a checkbox to get access
to deleted groups in the permissions interface. So it has been removed.
[David]

=back

=cut

##############################################################################

=head1 VERSION 1.7.4 "Sacramento" (2004-03-18)

=head2 New Features

=over

=item *

Added "Bulk Publish" feature in ADMIN->PUBLISHING that lets members of the
Global Admins group publish story and media documents by category. [Scott]

=item *

Added C<notes()> method to Bric::Util::Burner, along with the accompanying
C<clear_notes()>. The C<notes()> method provides a place to store burn data
data, giving template developers a way to share data among multiple burns over
the course of publishing a single story in a single category to a single
output channel. Any data stored here persists for the duration of a call to
C<burn_one()>. [David]

=item *

Added new contributed scripts for Bricolage button generation. These scripts
use the Gimp to generate localized buttons for the Bricolage UI based on the
contents of an input file. See F<contrib/button_gen/README> for details.
[Florian Rossol]

=item *

Added support for icons for all media documents when the C<USE_THUMBNAILS>
F<bricolage.conf> directive is enabled. These rely on the presence of PNG icon
files for each MIME type in F<comp/media/mime>. Only one such icons is
distributed with Bricolage, F<comp/media/mime/none.png> (borrowed from the KDE
project under L<http://artist.kde.org/new/license.html#others>), which is the
default icon when the MIME type of a media file is unknown or when no icon
file exists for the MIME type of the media file. Administrators are free to
add their own icons, and the C<copy_gnome_icons> script in F<contrib> makes it
easy to use GNOME icons. [David]

=item *

Added C<bric_template_diff> and C<bric_template_patch> scripts in
F<contrib/bric_template_diff>. These scripts can be used to sync templates
between two Bricolage servers. [Sam]

=item *

added C<bric_media_load> to C<contrib/>. This script copies media into
Bricolage while accounting for the new to update existing media. [Sam]

=item *

Added HTMLArea support. This adds a new type of field to be added to elements
and contributor types, "WYSIWYG". Such fields are then displayed in the UI
using HTMLArea, a WYSIWYG HTML editor. This can be useful in particular for
simple fields that often need emphasis added or links. It is not currently
available in Bulk Edit or Super Bulk edit. See L<Bric::Admin|Bric::Admin> for
installation and configuration details. [Eric Sellers]

=back

=head2 Improvements

=over

=item *

The list of categories for which permissions can be granted to user groups to
access the documents and templates in the category now displays the categories
for each site separately, so that categories with same URIs (such as for the
root category in each site) can be easily told apart. Reported by Ho Yin Au.
[David]

=item *

The list of workflows for which permissions can be granted in the permissions
page now includes the parenthesized name of the site each workflow is
associated with. [David]

=item *

Modified the indexes on the C<workflow__id> and C<desk__id> columns of the
story, media, and formatting (template) tables to be more efficient, being
indexed only when their IDs are greater than 0 (that is, when a story, media
document, or template is actually on a desk and in a workflow). [David]

=item *

Added a method C<is_fixed> to story and media objects, to determine whether
a business asset has a fixed URL (for example, a Cover page). Refer to
L<Bric::Biz::Asset::Business|Bric::Biz::Asset::Business>. [Scott]

=item *

Added the C<ENABLE_OC_ASSET_ASSOCIATION> F<bricolage.conf> directive
to remove the ability to associate output channels from the story
and media profiles. [Scott]

=item *

The element administration profile now automatically adds the currently
selected site context to new elements, thus generally saving a step when
creating new elements. [JoE<atilde>o Pedro]

=item *

Added an interface to 'Clone' for stories so that you can change the category,
slug, and cover date, because otherwise an identical story is created, which
would cause errors for some stories. Clones are no longer allowed to have URIs
that are identical to the stories they were cloned from. [Scott & David]

=item *

Added the ability to Delete from desks (same as My Workspace). Note however,
that you can't delete from a publish desk. [Scott]

=item *

Completely documented the document element classes:
L<Bric::Biz::Asset::Business::Parts::Tile|Bric::Biz::Asset::Business::Parts::Tile>,
L<Bric::Biz::Asset::Business::Parts::Tile::Data|Bric::Biz::Asset::Business::Parts::Tile::Data>,
and
L<Bric::Biz::Asset::Business::Parts::Tile::Container|Bric::Biz::Asset::Business::Parts::Tile::Container>.
This should make it a bit easier on templators learning their way around the
Bricolage API. [David]

=item *

Refactored quite a bit of the code in the element classes. Renamed the methods
with "tile" in their names to use "element" instead (but kept the old ones
around as aliases, since they're used throughout the UI). Added a few methods
to make the interface more complete. [David]

=item *

Modified the C<get_containers()> method of
Bric::Biz::Asset::Business::Parts::Tile::Container to take an optional list of
key name arguments, and to return only the container subelements with those
key names. This is most useful in templates, where it's fairly common to get a
list of container subelements of only one or two particular types out all at
once. It neatly replaces code such as this:

  for ( my $x = 1; my $quote = $element->get_container('quote', $x); $x++ ) {
      $burner->display_element($quote);
  }

With this:

  for my $quote ($element->get_containers('quote')) {
      $burner->display_element($quote);
  }

And is more efficient, too. [David]

=item *

Modified the C<get_elements()> method of
Bric::Biz::Asset::Business::Parts::Tile::Container to take an optional list of
key name arguments, and to return only the subelements with those key names.
[David]

=item *

Added the C<get_data_elements()> method to
Bric::Biz::Asset::Business::Parts::Tile::Container. This method functions
exactly like C<get_containers()> except that it returns data element objects
that are subelements of the container element. It also takes an optional list
of key name arguments, and, if passed, will return only the subelements with
those key names. [David]

=item *

The C<ANY()> subroutine will now throw an exception if no arguments are passed
to it. Suggested by Dave Rolsky. [David]

=item *

Added the C<unexpired> parameter to the C<list()> method of the story and
media classes. It selects for stories without an expire date, or with an
expire date set in the future. [David]

=item *

The "User Override" admin tool is now available to all users. But a user can
only override another user if she has EDIT permission to that other user. This
makes it easier for user administrators to masquerade as other users without
having to change passwords. [David]

=item *

Eliminated another SQL performance bottleneck with simple searches of media
assets. [JoE<atilde>o Pedro]

=item *

Images with no dimension greater than the C<THUMBNAIL_SIZE> F<bricolage.conf>
directive are no longer expanded to have one side at least C<THUMBNAIL_SIZE>
pixels, but are left alone. [David]

=item *

Thumbnails are now displayed when searching media to relate to an element.
[David]

=item *

Thumbnails are now displayed in related media subelements. [David]

=item *

Added C<preview_another()> method to Bric::Util::Burner. This method is
designed to be the complement of C<publish_another()>, to be used in templates
during previews to burn and distribute related documents so that they'll be
readily available on the preview server within the context of previewing
another document. [Serge Sozonoff]

=item *

Added the C<subelement_key_name> parameter to the C<list()> method of the
story and media classes. This parameter allows searches on the key name for a
container element that's a subelement of a story or media document. [David]

=item *

Added support for all of the parameters to the C<list_ids()> method of the
Story, Media, and Template classes to the C<list_ids()> method of the
corresponding SOAP classes. This allows for much more robust searches via the
SOAP interface. [David & Scott]

=item *

Eliminated C<login_avail()> PostgreSQL function, replacing it with a partial
constraint. This not only makes things simpler code-wise, but it also
eliminates backup and restore problems where the C<usr> table is missing. The
downside is that it requires PostgreSQL 7.2 instead of our traditional minimum
requirement of 7.1. So any PostgreSQL 7.1 users will need to upgrade before
upgrading to this version of Bricolage. Suggested by Josh Berkus. [David]

=back

=head2 Bug Fixes

=over

=item *

C<make clone> will now properly clone a database on a different database
server, provided the host name (and port, if necessary) have been
provided. Thanks to Ho Yin Au for the spot! [David]

=item *

Admin tool lists that include the number "9" in the corner of a table of items
is now properly orange instead of green. Reported by Ho Yin Au. [David]

=item *

Bricolage works with Perl 5.6.x again, although it's pretty strongly
deprecated. Perl 5.8.0 or later is required for character set conversion and
if any content uses characters outside of US ASCII. Thanks to John Greene for
the spot! [David]

=item *

Image files uploaded in formats not recognized by Image::Info no longer
trigger an error. Reported by Alexander Ling. [David]

=item *

Changing the cover date of a media document once again correctly updates the
primary URI of the media document. Reported by Serge Sozonoff. [David]

=item *

Fixed API that was causing no elements to be returned on "Add sub-elements"
page, when "Filter by site context" was turned on. [JoE<atilde>o Pedro]

=item *

When the SOAP server serializes and deserializes element templates, it now
correctly identifies the element by its key name, rather than its name. Thanks
to JoE<atilde>o Pedro for the spot! [David]

=item *

The template profile's "cheat sheet" of the subelements of an element now
correctly display subelement key names instead of munging element names, as
was required before version 1.7.0. [JoE<atilde>o Pedro]

=item *

C<< Bric::SOAP::Category->list_ids >> now converts site names to site IDs.
[JoE<atilde>o Pedro]

=item *

C<< Bric::Util::Burner->preview >> once again defaults to previewing in an
asset's primary output channel instead of using the element's primary output
channel. [JoE<atilde>o Pedro]

=item *

Added C<first_publish_date> attribute to the SOAP input and output for stories
and media. [David]

=item *

The category SOAP class now correctly calls C<lookup()> with the site ID to
prevent multiple categories with the same names but in different sites from
being looked up. [JoE<atilde>o Pedro]

=item *

User overrideable preferences are now properly checked for permissions to
allow users with READ permission to a user to see the permissions. [David]

=item *

Users can now edit their own user-overrideable preferences. [David]

=item *

Group management now works more correctly in user profiles where users have on
READ access to the user object. [David]

=item *

Removed queries added in 1.7.2 that were running at Bricolage startup
time. They could cause DBI to cache a database handle and return it after
Apache forks, leading to strange errors such as "message type 0x49 arrived
from server while idle", and occaisionally a frozen server. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.7.3 (2004-03-01)

=head2 New Features

=over

=item *

The virtual FTP server now moves templates into workflow when they're uploaded
and puts them into the user's sandbox. This behavior allows the user to test
the template changes without imposing possible bugs upon other Bricolage
users. This approach is much safer than the previous behavior, which simply
checked in and deployed a template upon upload. Templates can still be
deployed via the virtual FTP server by appending ".deploy" to their names. The
original behavior of always deploying templates upon upload can be restored by
enabling the C<FTP_DEPLOY_ON_UPLOAD> F<bricolage.conf> directive. [David]

=item *

Added C<ANY> function to be used with select parameters to story, media, and
template (formatting) list. Pass a list of values to this function to have any
of of them match for a given parameter. This is especially useful for matching
on, say, a list of URIs or category IDs. This function is automatically
available in templates. [David]

=item *

Added a feature that counts characters used in a textarea subelement on the
fly. It displays this figure and the number of characters left, immediately
above the textarea. This feature is enabled when the Max size attribute for the
textarea is given a non zero value when adding it to the element profile
stage. The JavaScript will also not allow you to have more than max size
characters in the textarea by truncating the data to that number of characters
every time someone adds another character beyond the maximum. [Paul
Orrock/Digital Craftsmen]

=item *

Added a feature to display image thumbnails in the search results and active
view for media objects that are image objects. This feature uses the Perl
module Imager from CPAN and the relevant image library for each format you
want to display. It can be turned on or off using the C<USE_THUMBNAILS>
F<bricolage.conf> directive. See
L<Bric::Biz::Asset::Business::Media::Image|Bric::Biz::Asset::Business::Media::Image>
for more information. [Paul Orrock/ Digital Craftsmen]

=back

=head2 Improvements

=over

=item *

The F<bric_media_upload> contributed script now provides a more meaningful
error message when it can't find F<bric_soap>. [Dave Rolsky]

=item *

The F<bric_dist_mon> C<-U> option no longer requires that "/dist/" be at the
end of the URL. If "/dist/" is missing, F<bric_dist_mon> will append it.
[David]

=item *

More story, media, and template query optimization. [David]

=item *

The story, media, and template queries now use aggregates to create arrays of
group IDs, instead of returning a separate row for each individual group
ID. Since all story, media, and template objects are now returned in single
rows instead of potentially many rows, this greatly cuts down on the overhead
of fetching data from the database. Suggested by Josh Berkus; implementation
help from David Fetter. [David]

=item *

Thanks to the aggregation of group IDs into a single row for each story, media
and template object, the C<Offset> and C<Limit> parameters to the C<list()>
methods of the story, media, and template (formatting) classes are now handled
by the database back end, instead of in Perl space. This makes using these
parameters much more efficient.

=item *

Added C<-k> option to F<bric_ftpd> to kill a currently running virtual FTP
server. This is made possible by the addition of the new C<FTP_PID_FILE>
F<bricolage.conf> directive. [David]

=item *

Asset groups associated with categories are now activated or deactivated
whenever their corresponding categories are now activated or deactivated.
This prevents them from showing up in the permissions interface. [David]

=item *

Added a check box to the permissions interface to enable the display of
inactive groups. This is primarily so that permissions can be modified on
inactive category groups, since they still affect access to any documents and
templates in those categories, even after they're deactivated. [David]

=item *

Updated documentation to reflect the reality that one should really only use
Perl 5.8.0 and later if one needs to use any characters outside of ASCII.
[Andrea Rota]

=item *

Added C<FTP_UNLINK_BEFORE_MOVE> F<bricolage.conf> directive. This forces the
FTP mover to unlink an older version of a file before renaming the new version
to that name. This is necessary for some FTP servers that won't disallow
renaming a file to replace an existing file. [Andrea Rota]

=item *

Updated zh-cn and zh-tw localizations, translating all untranslated
messages and JavaScript messages. [Kang-min Liu]

=item *

Relabeled the "Pre" and "Post" attributes of output channels as "URI Prefix"
and "URI Suffix", respectively. [Serge Sozonoff]

=item *

Added C<get_element()> method to Bric::Biz::Asset::Business and deprecated the
C<get_tile()> method. This will make things a bit more consistent for template
developers, at least. [David]

=item *

Added C<primary_category_id> parameter to the story class' C<list()>
method. [David]

=item *

Updated the German localization. [Thorsten Biel]

=item *

Users can no longer sneakily add subelements for which they do not have at
least READ permission to the corresponding element via the Super Bulk
Edit. Reported by Patrick Walsh. [David]

=item *

The list of output channels available to be included in an output channel now
has the name of the site with which each is affiliated listed as well. This is
to prevent confusion between output channels with the same names in different
sites. [David]

=item *

Changed the vertical alignment of the labels for textarea fields in the story
profile to be consistent with the labels on the element profile. i.e. top
aligned. [Paul Orrock/Digital Craftsmen]

=item *

Made the default installed "Photograph" and "Illustration" media document
types true image objects, with autopopulated fields for height, width,
etc. Suggested by Simon Wilcox. [David]

=item *

Changed the default value of the C<SMTP_SERVER> F<bricolage.conf> directive to
localhost. This has a much greater chance of working than defaulting to the
value of the C<VHOST_SERVER_NAME> directive. [David]

=item *

Eliminated the term "Asset Type" from the UI, replacing it with "Element",
"Story Type Element", or "Media Type Element", as context demands. [David]

=item *

The Contributor manager no longer presents a "New" link if the Contributor
Type on which the contributor is based has no custom fields. This will prevent
folks from creating new contributor roles in the UI only to find that Bricolage
hasn't created them because there are no custom fields. [David]

=item *

In the formBuilder interface used by the Element and Contributor Type
profiles, the default maximum length of text and textarea fields is now "0",
or unlimited. [David]

=item *

When publishing from a publish desk, you can now uncheck related assets in
order to not publish them. You can also unset the C<PUBLISH_RELATED_ASSETS>
F<bricolage.conf> directive to never publish related assets. [Scott]

=back

=head2 Bug Fixes

=over

=item *

The virtual FTP server now correctly creates a utility template when a
template with an unknown name is uploaded. [David]

=item *

The virtual FTP server now pays proper attention to all permissions. [David]

=item *

A number of upgrade script annoyances were cleared up. [David]

=item *

The C<simple> parameter to the Media class' C<list()> method works again. As a
result, so does "Find Stories" in the UI. [David]

=item *

The de-de localization library has been fixed so that it now works. [David]

=item *

Filter by site context now works. 'All sites' context now returns results from
all sites instead of none. [JoE<atilde>o Pedro]

=item *

Several Alert Type fixes. Rule regular expression matching (=~, !~) now
handles patterns containing slashes (important for URIs, for example).
Attributes no longer show up as stringified hash references in subject or
message variable substitution. C<$trig_password> was removed from the Profile
as it caused an error and was useless anyway. And finally, duplicate and
spurious attributes were removed from the rules and message variable
lists. [Scott & David]

=item *

Fixed Template Element list, where container elements appeared twice.
[JoE<atilde>o Pedro]

=item *

The deletion of a site now properly resets the workflows to be displayed in
the side navigation layer. [David]

=item *

Changes to site settings are now correctly reflected in the UI for all users
as soon as they are made. [David]

=item *

New media documents no longer attempt to validate URI uniqueness until a file
has been uploaded. [David]

=item *

Autopopulated fields in media elements can once again have their values
fetched in templates. This problem was due to bad key names being created for
new image elements created after upgrading to 1.7.0. [David]

=item *

The workflow profile no longer displays deactivated sites in the site select
list. Thanks to Serge Sozonoff for the spot. [David]

=item *

The upgrade script that adds the C<first_publish_date> attribute to the
database now properly sets that date for existing assets, no matter how many
"publish" events have been logged. There should be only one, but some systems
apparently have more. [Thorsten Biel]

=item *

Media, Story, and Template groups now properly display all of the permissions
that can be granted to user groups to access them. [David]

=item *

The "Next" button in the Element Type profile now correctly loads the next
page of the profile instead of returning to the manager. [David]

=item *

Fixed URI uniqueness upgrade scripts, which were having problems with
PostgreSQL permissions. [David]

=item *

C<make clone> works again. [David]

=item *

Fixed database building installer scripts to use the C<$PGHOST> environment
variable when it has been explicitly set to "localhost", both to override
existing instances of that variable on a system, and to allow tunneling
to work properly. [Thorsten Biel]

=item *

Distribution jobs can be edited via the UI again. Thanks to Marshall Roch for
the spot. [David]

=item *

Publishes once again work when the "Date/Time Format" preference is set to
something other than ISO-8601. Reported by Marshall Roch. [David]

=item *

C<bric_dist_mon> now I<correctly> appends "/dist/" to the end of the server
URL if it is not already appended. Reported by Marshall Roch. [David]

=item *

If a desk is in a template workflow and a story or media workflow, and you
attempt to publish a media or story document from that desk in the context of
the template workflow, it will now properly publish the story or media
document instead of throwing an error. Reported by Serge Sozonoff. [David]

=item *

Fixed previewing with multiple OCs. [Serge Sozonoff]

=item *

Fixed a bug in C<bric_soap story create/update> caused by refactoring in
version 1.7.0. Found by David during a demo. [Scott]

=item *

An attempt to preview a story for which no template exists now gives a
friendly error message again. This was broken by the change in 1.7.2 that made
the Mason burner use document templates as true dhandlers. [Dave Rolsky]

=item *

The workflow menus in the side navigation layer no longer disappear after a
server restart. Reported by Ben Bangert. [David]

=item *

The Mason burner's special C<< <%publish> >>, C<< <%preview> >>, and
C<< <%chk_syntax> >> tags now work as advertised. Reported by Ben Bangert.
[David]

=item *

Publication of stories and media that automatically schedule expiration jobs no
longer causes an error. Reported by Marshall Bloch. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.7.2 "Kat" (2004-02-12)

=head2 New Features

=over

=item *

Bricolage now has a much more robust security policy. Users with permission to
edit various objects and groups in the administrative interface can no longer
increase their permissions. Nor can they manage the membership of groups of
which they are not members or do not have EDIT access to the members. All this
is to prevent users from giving themselves higher permissions. [David]

=item *

Added C<publish_another()> method to Bric::Util::Burner. This method publishes
a document other than the one currently being published. This is useful when a
template for one document type needs to trigger the publish of another
document. [David]

=item *

Added new permissions "RECALL" and "PUBLISH". These permissions apply only to
asset groups, including desks, categories, and workflows. Now users must have
RECALL permission to recall assets from the library and bring them into
workflow, and PUBLISH permission to publish assets. This should make it much
easier to create more flexible permissions to manage approval
processes. [David]

=item *

Bricolage now supports per-user preferences. Admins can mark a preference as
overrideable, which allows users to set this preference to their preferred
value. [Dave Rolsky]

=item *

The character set and language preferences have been moved into the database,
so that these can be overridden by individual users if needed. [Dave Rolsky]

=item *

Added C<--published-only> option to F<bric_soap> and F<bric_republish> so that
the last-published version of a document can be republished, rather than the
current version. [Scott]

=item *

Added Bric::Util::Job::Pub. Publication can now be placed into a queue and
deferred until a scheduled time, instead of burning on command and
distributing later, Bricolage will now burn a story at the time of the
scheduled distribution. [Mark]

=item *

Added the C<bric_queued> daemon to take advantage of the new publication
scheduling of Bric::Util::Job::Pub. Together with the use of a carefully tuned
instance of Bricolage, these new features allow the Bricolage administrator
to control the amount of system resources given over to publishing. [Mark]

=item *

German localization completed. [Thorsten Biel]

=item *

Added C<get_parent()> method to Bric::Biz::Asset::Business::Parts::Tile. This
simplifies getting access to a parent element in an element template. [David]

=item *

Added User and Desk (asset) modules to the SOAP API, added asset commands
to the Workflow module, and made corresponding changes to bric_soap. [Scott]

=item *

Added C<burn_again> attribute to the Mason burner. This method can be called
from within a template to force the burner to burn the current page again,
creating a new file. This can be useful for creating multi-file output
without extra paginated subelements. [David]

=item *

Added zh-cn localization, with translation based on zh-tw. [Kang-min Liu]

=back

=head2 Improvements

=over

=item *

A field that is both required and repeatable now allows instances of the field
after the first instance to be deleted. Setting a field to required
essentially means that one must always be present in the UI. [David]

=item *

HTML::Template and Template Toolkit are now optional. If they're not installed
on your system, they won't be loaded by Bricolage. [David]

=item *

The default "Story Editors," "Media Producers," and "Template Developers" user
groups now have READ permission to the members of the "All Sites" group so
that they can properly select a site context and gain access to the workflows
in their site context. [David]

=item *

A number of improvements for the F<bric_media_upload> contrib script:

=over

=item Creates intermediate categories if needed.

=item Added a C<--skip-existing> directive.

=item Added a C<--media-info> directive.

=back

See the script's usage info for details. [Simon Wilcox]

=item *

Fixed upgrade scripts to be more intelligent in their handling of
transactions. They no longer allow SQL errors without failing the upgrade. The
upgrade scripts have also been updated to ensure successful upgrades to
Bricolage installations as far back as 1.4.0. [David]

=item *

C<make upgrade> now suggests that the user run C<make clone> on the existing
installation, and asks the whether to continue or not. This is to encourage
folks to have a good backup before upgrading, in case the upgrade fails.
[David]

=item *

Added C<element_key_name> parameter to the C<list()> method of the story,
media, and formatting classes. This makes it easier to use the name of a story
type element, media type element, or template element to search for assets,
rather than the C<element__id> parameter, which isn't as friendly. [David]

=item *

Added "Filter by Site Context" preference. When active, search results only
return assets relative to the site context instead of all the sites the user
has access to [JoE<atilde>o Pedro]

=item *

The Mason burner now uses document templates as true dhandlers, enabling full
Mason-style inheritance from autohandlers to work properly. [David & Dave
Rolsky]

=item *

"All *" groups can now be accessed via the Group Manager. Their names and
memberships cannot be edited, but their permissions can. Inspired by a bug
report from Patrick Walsh. [David]

=item *

Queries for stories, media, and templates have been greatly optimized. Thanks
to a large database from I<The Register> and query optimization from Josh
Berkus (under sponsorship from WHO) and Simon Myers of GBDirect, searches for
stories in the UI are now 10-40 times faster than they were before (depending
on the version of PostgreSQL you're running). [David]

=item *

Added the C<story.category> parameter to the C<list()> method of
Bric::Biz::Asset::Business::Story. Pass in a story ID, and a list of stories
in the same categories as the story with that ID will be returned, minus the
story with that ID. This parameter triggers a complex join, which can slow the
query time significantly on underpowered servers or systems with a large
number of stories. Still, it can be very useful in templates that want to
create a list of stories in all of the categories the current story is in. But
be sure to use the <Limit> parameter! Thanks to Josh Berkus for his help
figuring out the query syntax. [David]

=back

=head2 Bug Fixes

=over

=item *

The "Checkout" checkbox is no longer missing in the Find interface for documents
and templates that are already in workflow. [David]

=item *

Category groups can be edited again. Reported by Alexander Ling. [David]

=item *

Elements can be edited again. Thanks to Alexander Ling for the spot! [David]

=item *

Element fields can be edited again without encountering the "called the
removed method 'get_name'" error. Reported by Alexander Ling. [David]

=item *

Improved the upgrade script for converting field definitions to use key
names, thanks to reports from Nate Perry-Thistle. [David]

=item *

Made the index on field key names case-insensitively unique. [David]

=item *

Restored category asset group permissions in user group profiles. [David]

=item *

Templates can be deleted again. Thanks to Adeola Awoyemi for the spot! [David]

=item *

Stories and media with non-unique URIs can now be deleted. Reported by Simon
Wilcox. [David]

=item *

Checkin and Publish once again works in the media profile. Thanks to Alexander
Ling for the spot. [David]

=item *

Adding users to any of the default site user permission groups no longer
incorrectly allow those users to select that site for their context. Reported
by Alexander Ling. [David]

=item *

The inline "Bulk Edit" feature in story and media profiles works again. Thanks
to Neal Sofge for the spot! [David]

=item *

Fixed 1.7.0 upgrade scripts that create key names to better handle key name
conflicts. Thanks to Nate Perry-Thistle for having an installation that
generated such conflicts. [David]

=item *

Attempting to create a destination with the same name as an existing or
deleted destination no longer causes an SQL error. Thanks to Simon Wilcox for
the spot! [David]

=item *

Templates are now correctly saved to the user's sandbox when "Save and Stay"
is pressed. [JoE<atilde>o Pedro]

=item *

Select lists now correctly save their states so that, for example, dropdown
menus in New Story remember the element and category that was selected last
time. [Scott]

=item *

Group membership now correctly shows the site name for each object when
there is more than one site in the installation. [JoE<atilde>o Pedro]

=item *

Sites can now be disassociated with elements. Reported by Alexander Ling.
[David]

=item *

Redirects during previews work again. [David]

=item *

The virtual FTP server works again for the first time since before the release
of 1.7.0. Now when you log in to the FTP server, the root directory will
contain a list of sites. When you change directories into one of the site
directories, you'll see a list of the output channels in that site. [David]

=item *

The virtual FTP server no longer displays output channels or categories (or
sites) that the user does not have at least READ permission to access. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.7.1 (2003-11-30)

=head2 Improvements

=over

=item *

The members of the "All" groups are prevented from being changed in the
callbacks now, as well as in the interface, where a JavaScript function had
been preventing it. [David]

=back

=head2 Bug Fixes

=over

=item *

Passwords can be changed again. [Mike Slattery]

=item *

It is now virtually impossible to create media type or story type elements
without site and output channel associations. This should eliminate errors
when users try to create documents based on types without output channel
associations. [David]

=item *

The "Output Channel" item for templates on desks now displays properly.
[David]

=item *

Eliminated bogus "Use of element's 'name' field is deprecated" warnings. Key
names are allowed to have digits and underscores, and we weren't consistent
about that. [David]

=item *

The C<display_element()> method in the Mason burner once again passes
component arguments on to components. And now, so does C<sdisplay_element()>.
[David]

=item *

Fixed F<favicon.ico> code so that the browser and server don't go into an
infinite loop with redirects of redirects. The F<favicon.ico> still doesn't
pop up in the location field in my browser, but it does display properly if I
point my browser at it. [David]

=item *

An attempt to create a document with the same URI as an existing document no
longer litters the database with broken stories. Thanks to Arthur for the
spot. [David]

=item *

Redirection after some publishes and previews works again, instead of
returning a text page to the browser. [David]

=item *

Now displaying the name of the site each story and media document is in in
Find Stories and Find Media. Suggested by Arthur. [David]

=item *

A number of fixes for the F<bric_media_upload> contrib script:

=over

=item Made it work with the 1.7.0 XML Schema.

=item Fixed a bug in its use of File::Find.

=item Fixed problem in calculating category names when given a directory to upload.

=item Added C<--bric_soap> and C<--site> options.

=back

See the script's usage info for details.  [Dave Rolsky]

=item *

Changing a media item's category and then saving caused an error.
[Dave Rolsky]

=item *

Changing a media document's cover date no longer causes the URI to disappear.
Thanks to Dave Rolsky for the spot. [David]

=item *

Attempting to preview a story for which there are no associated destinations
no longer causes the error 'Can't call method "ACCESS" without a package or
object reference'. Thanks to Earle Martin for the spot! [David]

=item *

Added C<output_channel_id> parameter to the C<list()> method of Bric::Biz::Site
in order to prevent sites without output channel associations from being
listed in the select list for story type and media type elements. [David]

=item *

When a document fails to publish because there are no destinations configured,
the UI no longer displays a message saying that it was published. [David]

=item *

Fixed page logging so that redirects to the page before the current page can
work correctly. It was most noticeably broken when trying to associate a
contributor with a document. [David]

=item *

The upgrade process no longer moves media document files to where Bricolage
can't find them. If this happened to you, just
C<mv $BRICOLAGE_ROOT/comp.old/data $BRICOLAGE_ROOT/comp>. [David]

=item *

Performing an action in the contributor and category association interfaces in
the story and media profiles no longer causes an empty search to be performed
and return all contributors or categories. This could be a pain for
organizations with 1000s of contributors or categories. Thanks to Scott for
the report! [David]

=item *

The Key Name field in the element profile is no longer editable. Only new
elements can type in the key name field. Thanks to Arthur for the spot!
[David]

=item *

The Template toolkit burner now correctly uses element key names instead of
names to find corresponding templates. [David]

=item *

Management of user groups in a double list manager UI no longer causes an SQL
error. Spotted by Alexander Ling. [David]

=item *

Sites added to a site group will now be listed as members of the site group in
the site group's profile. Thanks to Alexander Ling for the spot. [David]

=item *

Improved permission checking in the virtual FTP server. [David]

=item *

Uploading a new version of a media file did not change the path to the
media file stored in the database, unless the file name of the media
was also changed. [Dave Rolsky]

=back

=cut

##############################################################################

=head1 VERSION 1.7.0 (2003-10-22)

=head2 New Features

=over

=item *

Added multisite support. Now all stories, media, output channels, templates,
categories, and workflows may be associated with different sites, and even
have the same names in different sites. This simplifies the management of
multiple Web sites with Bricolage. Story type and media type elements may be
shared between sites. Funded by Portugal Telecom Multimedia. [David, Arthur,
Garth, & JoE<atilde>o Pedro]

=item *

Added document aliasing. Stories and media in a site may now be aliased and
published in another site, as long as the elements on which they are based
are shared between sites. Control over the content of aliased documents
remains in the original site, thus ensuring the editorial integrity of the
document for that site. Funded by Portugal Telecom Multimedia. [David]

=item *

Changed element attribute "name" to "key name" to emphasize its uniqueness
within an element. Also changed the "Display Name" to "Label" [Garth]

=item *

Added a "key_name" attribute to elements as the system-wide unique key for
each element, rather than the name. The name is now used as a label. Note that
the key name only allows certain characters, as it is used to name the
template files that format the element. This makes the C<has_name()> method a
bit simpler -- and it can in fact be ignored in favor of
C<< $element->get_key_name eq $key_name >>. Thus there may be some warnings
if older name values are passed to C<has_name()>. [Garth]

=item *

Refactored Bric::Biz::Keyword. It is now more compliant with the standard API
as defined in other classes. Also added support for keyword groups so that we
can create a keyword manager. [David]

=item *

Added C<< $burner->sdisplay_element >> method to Bric::Util::Burner. This is a
C<sprintf>-style version of C<< $burner->display_element >>. [Scott]

=item *

Added C<get_data_element()> method to
Bric::Biz::Asset::Business::Parts::Tile::Container. This allows template
writers to more easily find a single data element object, rather than just the
value of a single data element (as C<get_data()> does). Inspired by a comment
from Bill Cappel. [David]

=item *

Added the C<YEAR_SPAN_BEFORE> and C<YEAR_SPAN_AFTER> F<bricolage.conf>
directives. These directives control how many years before and after
the current year to display in the list of years in the date and time select
widget. The default values are 10 for each, meaning that if the current year
is 2003, then the date span will be from 1993 to 2013.

=item *

Added the C<ENABLE_SFTP_V2> F<bricolage.conf> directive to make
SSH protocol 2 be tried first. [Scott]

=item *

Added "Email" action, which can be used to email the files generated by a
publish to one or more email addresses. Funded by ETonline. [David]

=item *

Callbacks were moved from Mason components to modules based on
Params::Callback and managed by MasonX::Interp::WithCallbacks. This makes the
UI layer more responsive and enhances maintainability. [Scott]

=item *

Optimized performance of URI uniqueness checks by adding database tables to do
the job, rather than constructing the URIs for all other documents in the same
categories as the document being checked. This was the last major bottleneck
affecting SOAP performance, as well as document editing in general. Funded by
Kineticode. [David]

=item *

Added C<instance()> class method to Bric::Util::Language, so that non-OO
functions can get access to the current language handle. [David]

=item *

Added C<output_channel_id> parameter to the C<list()> methods of Story and
Media to enable querying for documents in output channels other than the
primary output channel. Based on a patch from Clive Jones. [David]

=item *

Lots of notification message localization fixes. [Radu Greab]

=item *

Status message localization fixes [David]

=item *

Added "search by element type" to Advanced Search of the Find Stories
and Find Media interfaces. [Scott]

=item *

Added a preference to select Simple or Advanced search in Find Stories/Media
the default search when you go to those screens. [Scott]

=item *

Added "Select all" button to select all the checkboxes on publish desks or My
Workspace. [Scott]

=item *

Added Keyword Management interface to centrally manage keywords. [Scott]

=item *

Added C<--workflow> and C<--desk> options to create and update commands of
C<bric_soap>, so that assets can be moved to a desk at the same time as
creation or updation. [Scott]

=item *

Added Group Membership sections to most of the profiles. [JoE<atilde>o Pedro]

=item *

Some optimizations to Bric::SOAP::(Media|Story|Template) classes. [Scott]

=item *

Added HTML::Mason Custom tags support, allowing template developers to write
code blocks that are context sensitive. See L<Bric::AdvTemplates> for
documentation on this. [JoE<atilde>o Pedro]

=item *

Added new page extension support to the burner, which allows template
developers to set string extensions to use for successive file names, rather
than the traditional use of numeric file name extensions for successive file
names. [Clive Jones]

=item *

Added "Text to search" option in the Advanced search of Media and Stories to
search for documents based on the contents of their field. [JoE<atilde>o
Pedro]

=item *

All preview links are now generated by a single widget. This widget adds the
story or media URI to the "title" attribute of the link tag (which is modern
browsers will automatically work as a roll-over tooltip), makes the story or
media URI copyable (by relying on JavaScript to actually open a new window for
the preview), and manages selecting an output channel in which to preview a
story. [David]

=item *

Made User Group Permissions UI wieldy with larger numbers of users by adding a
select list to choose which type of Permission to look at. [Scott]

=item *

Added ability to preview stories in a selection of output channels in the View
(read-only) story profile. [David]

=item *

Combined the asset "Find" managers into a single component, thus eliminating a
lot of redundant code. [David]

=item *

Added C<contrib_id> parameter to the C<list()> methods of
Bric::Biz::Asset::Business::Story and Bric::Biz::Asset::Business::Media to
return a list of story or media documents associated with a given
contributor. [David]

=item *

Switched Bric::Util::CharTrans from using Text::Iconv to Encode, thus removing
the dependency on a C library (libiconv). Note that this has changed the API
of Bric::Util::CharTrans. Its C<to_utf8()> and C<from_utf8()> methods now
always convert the argument passed in in place. They did this before for
references, but now they do it for plain strings, as well. Also note that use
of character translation also now requires Perl 5.8.0 or later. [Scott &
David]

=item *

Factored out some of the SOAP asset classes into Bric::SOAP::Asset. [Scott]

=item *

Added MediaType, Site, and Keyword SOAP modules. [Scott]

=item *

Changes to a story's slug, cover date, or primary category will now be
displayed before the story is saved. Suggested by a coworker of Andy
Baio. [David]

=item *

The Find Stories, Find Media, and Find Templates interfaces now disallow
searching for and returning all of the stories and media in the database. This
will help prevent thousands or tens of thousands of assets from being
displayed in the UI and sucking up all the resources on the server. [David]

=item *

Added "element" attribute to Bric::Util::Burner so that
C<< $burner->get_element >> should always return the element currently being
burned. [David]

=item *

Added burner-specific exceptions with context information, including current
output channel, current category, and current element. [David]

=item *

Added a C<throw_error()> method to Bric::Util::Burner so that template developers
can easily throw an exception that their users will see in the UI. [David]

=item *

Added C<best_uri()> method to Bric::Util::Burner to return the most
appropriate URI (in Bricolage's opinion) for a document. Mainly useful when
multiple sites and document aliases are used. [David]

=item *

Greatly simplified burner subclassing by adding a new registration method to
Bric::Util::Burner. This cuts down on the number of files that need to be
edited to add a new burner. [David]

=item *

Moved category selection from Media and Story Profiles into their own separate
components so that organizations with hundreds or thousands categories don't
have to load them into a dropdown list every time an asset is edited. The
category "browser" uses an interface similar to 'Associate Contributors',
which has the advantage of being searchable rather than looking through a
"long list of all categories". This feature can be enabled via the new
C<ENABLE_CATEGORY_BROWSER> F<bricolage.conf> directive. [Scott]

=item *

Added list paging to Desks and My Workspace. [Scott]

=item *

XHTML/CSS-ized desk items. This approach is the future of the Bricolage
interface: purely structural HTML, with CSS to create the presentation.
Eventually, we'll be able to have UI preferences to change font sizes or the
entire look and feel just by switching style sheets. But for now, this change
should help with the display of desks with many items on them, and it should
also speed the display of such desks. Turn off the C<USE_XHTML>
F<bricolage.conf> directive to get the old desk views back (useful for older
browsers). [David]

=item *

Added a preference to set the default Story/Media sorting. [Scott]

=item *

Added the ability to test templates without having to deploy them by using
"template sandboxes" for each template developer. [JoE<atilde>o Pedro]

=item *

Added Template Toolkit burner support. [Arthur/Fotango]

=item *

Added a F<bricolage.conf> directive, C<ALLOW_SLUGLESS_NONFIXED>, to prevent
slugless non-fixed (non-Cover) stories. [Scott]

=item *

Added support for installing and upgrading Bricolage with PostgreSQL on a
separate host. [Thorsten Biel]

=item *

Added context-sensitive help for pages that were missing it. [Scott]

=item *

C<make upgrade> no longer simply overwrites the contents of the UI component
root (F<$BRICOLAGE_ROOT/comp>), but renames it F<$BRICOLAGE_ROOT/comp.old> and
writes out a new one. This is both so that deleted UI component files don't
remain behind after an upgrade, and so that users can access any files that
they've changed in the old component root. Most users can just delete it after
upgrading. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.6.14 (2004-05-02)

=head2 Bug Fixes

=over

=item *

C<make upgrade> once again correctly creates F<postgres.db> if the existing
installation doesn't know the installed version of PostgreSQL. [David]

=item *

Adding notes to image, video, or audio media documents no longer causes an
error. Reported by Christian Hauser. [David]

=item *

Errors in the C<PERL_LOADER> F<bricolage.conf> directive no longer silently
fail. [David]

=item *

A successful login no longer redirects back to the login page, thus no longer
forcing a second redirect in such cases. Reported by Marshall Roch. [David]

=item *

The C<$burner> object is now available in Mason template C<< <%once> >> blocks
during the syntax check, although C<$story> and C<$element> are not. All three
are in the C<< <%once> >> block during previews and publishes. This means that
they can all be used in a C<< <%once> >> block like this:

  <%once>;
  unless ($burner->get_mode == SYNTAX_MODE) {
      # Do stuff with $story or $element.
  }
  </%once>

Reported by Serge Sozonoff. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.6.13 "Tripled" (2004-04-10)

=head2 Bug Fixes

=over

=item *

Deactivated groups no longer affect permission checking. Discovered thanks to
a bug report from Serge Sozonoff. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.6.12 "Tov" (2004-04-09)

=head2 Bug Fixes

=over

=item *

Warnings are no longer fatal. This was only the case ouside of mod_perl, and
so was probably quite rare, anyway. [David]

=item *

Upgrades no longer cause an error during the execution of
F<inst/db_grant.pl>. Reported by Abdul Halim Mazahar. [David]

=item *

Alerts once again properly check the attributes of the events that trigger
them. Reported by Patrick Walsh. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.6.11 "Green" (2004-03-17)

=head2 Bug Fixes

=over

=item *

A checkbox that is unchecked in an element no longer reverts to checked when
clicking "Save and Stay". Reported by Scott Lanning. [David]

=item *

Date parameters to the C<list()> methods of the story, media, and template
classes are now properly converted to UTC (and the database internal format)
before being passed to the database. [David]

=item *

Elminated some warnings. Reported by Christian Hauser. [David]

=item *

Simplified error handling in the C<Bric> base class and when running outside
of C<mod_perl>. [David]

=item *

Fixed issue with load order directives in Bricolage dynamic F<httpd.conf>
generation. This had caused the C<PREVIEW_MASON> directive to not work in some
cases. Incidentally, this change also allows dynamic configuration of mod_perl
1.26 and earlier. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.6.10 "Jump" (2004-02-29)

=head2 Bug Fixes

=over

=item *

Added missing index to the C<workflow__id> column of the C<story>, C<media>,
and C<formatting> (template) tables. [David]

=item *

Made index on the C<desk__id> column of the C<story>, C<media>, and
C<formatting> (template) tables a partial index, since the column will usually
be C<NULL>. [David]

=item *

Added an index to the description column of the C<story_instance>,
C<media_instance>, and C<formatting> (template) tables to speed up simple
searches. [David]

=item *

Added missing foreign key constraints for the C<desk_id> column of the
C<story>, C<media>, and C<formatting> (template) tables. [David]

=item *

C<make clone> no longer fails when it can't find F<httpd.conf>, because it
no longer looks for it. [David]

=item *

C<make clone> no longer assumes that the F<conf> directory is in
C<$BRICOLAGE_ROOT>, and prompts the user to find out. [David]

=item *

Bricolage once again works with Perl 5.6.x and Perl 5.8.1. [David]

=item *

Made F<bric_republish> and F<bric_dev_sync> safe to use with C<https://>.
[Geoff Richards]

=item *

The user object is no longer instantiated from the database every time a user
sends a request to Bricolage. It appears that this bit of overhead has
unfortunately been imposed on every request since Bricolage 1.0 due to a very
stupid typo. [David]

=item *

The creation of the Bricolage PostgreSQL user and database during installation
no longer complains about usernames or database names with dashes and other
non-alphanumeric characters in them. Thanks to Marshall Roch for the spot!
[David]

=item *

Fixed ancient bug revealed by the release of DBI 1.41. [David]

=item *

Photoshop-generated images no longer make Bricolage choke when they're
uploaded to a Media profile that autopopulates fields. Reported by Paul
Orrock. [David]

=item *

The C<lookup()> method of the story, media, and template classes will now
correctly return inactive objects. [David]

=item *

Fixed typo of C<CHECK_FREQUENCY> in Bric::Config that made it always use the
default of 1. [Scott]

=item *

The C<lookup()> method of the story, media, and template classes once again
attempt to retrieve objects from the per-request cache before looking them up
in the database. [David]

=item *

Changed the name of the event logged when templates are checked out from
"Template Checked Out Canceled" to the correct "Template Checked Out." [David]

=back

=cut

##############################################################################

=head1 VERSION 1.6.9 (2004-02-06)

=head2 Bug Fixes

=over

=item *

Fixed installation and upgrade scripts to use the same F<perl> binary as was
used to execute F<Makefile.PL>. This ensures that all necessary CPAN modules
will be correctly installed and located. [Simon Wilcox]

=item *

Story profile JavaScript validation works again. Thanks to Simon Wilcox for
the spot! [David]

=item *

Eliminated the need for the Apache::ConfigFile module, and thus some annoying
problems with the CPAN indexer when trying to install it. [David]

=item *

Fixed order of SQL statement execution upon installation so that dependencies
are properly handled. [Mark]

=item *

New file resources created for distribution are now created with the proper
media type. [Mark]

=item *

The German localization module (Bric::Util::Language::de_de) had the wrong
package name, which meant that attempts to use it failed with the error "Can't
locate class method 'Bric::Util::Language::de_de::new' via package
'Bric::Util::Language::de_de'". [Dave Rolsky]

=item *

Added new path to find PostgreSQL installed by some Debian packages. [Cinly
Ooi]

=item *

Workflows with special characters such as "+" and "&" now work properly in the
side navigation. Thanks to Patrick Walsh for the spot! [David]

=item *

Start desks can no longer be removed from workflows. This prevents workflows
from having no desks, thus avoiding problems adding desks to such
workflows. Reported by Patrick Walsh. [David]

=item *

Pushing the cancel button in a desk profile and then in a workflow profile
no longer redirects back to the desk profile. [David]

=item *

Made publish_date not be empty when publish is done through
the SOAP API and no publish_date argument is passed. [Scott]

=item *

Fixed CPAN installer to correctly update the list of modules to be installed
after a module has been successfully installed. Reported by Perrin Harkins.
[David]

=item *

Checkout checkboxes no longer appear for assets that users don't have
permission to check out. Thanks to Alexander Ling for the spot! [David]

=item *

Bric::Biz::AssetType::Parts::Data's C<lookup()> method now returns deactivated
objects, as it should. Thanks to Nuno Barreto for the spot. [David]

=item *

Events with attributes with the same name as attributes of the object the
event was triggered on (a common occurrence) no longer confuses the two. Thanks
to Todd Tyree for the spot. [David]

=item *

Users granted permission to access the members of a group via two user group
associations now always get the highest priority permission, as it should
be. Thanks to Patrick Walsh for the spot. [David]

=item *

Textarea fields in elements no longer lose some of their default data after
editing the field in the element manager. Reported by Todd Tyree. [David]

=item *

Media assets now properly remember their class, which means that autopopulated
fields (such as "height" and "width" for images) are autopopulated when a new
image file is uploaded. Thanks to Patrick Walsh for the spot! [David]

=item *

Updated Chinese Traditional localization. [Kang-min Liu]

=back

=cut

##############################################################################

=head1 VERSION 1.6.8 (2003-11-29)

=head2 Bug Fixes

=over

=item *

Custom select fields now correctly pay attention to the size attribute.
Reported by Dave Rolsky. [David]

=item *

The element type manager now displays "Subelement" instead of "Story" for
subelement element types. Suggested by Dave Rolsky. [David]

=item *

Updated to work with PostgreSQL 7.4. [David]

=item *

Improved error message in Bric::Util::Trans::SFTP. [David]

=item *

It's possible to create new stories again without running into errors saying
that a URI is not unique because the cover date and slug were accidentally
excluded from the URI. [David]

=item *

Mason story templates now inherit from all category templates, thus enabling
the access of C<< <%attr> >>s and calling of C<< <%method> >>s in category
templates from story templates. [David]

=item *

Permission to edit element fields is now based on the permissions granted to
edit the elements they belong to. This means that users other Global Admin
group members can now edit fields. [David]

=item *

Dates are no longer editable if a user doesn't have permission to edit them.
[David]

=item *

Users without EDIT access to an element no longer see a link to Edit fields
of that element, but a link to View them, instead. They will also no longer
see an "Add Subelements" button. [David]

=item *

Fixed bug that triggered an invalid error message when a story URI is non-unique.
Reported by Kevin Elliott. [David]

=item *

Assets with the same IDs but in different classes (media vs. stories vs.
templates) no longer prevent each other from being added to a desk that can
contain different classes of assets. Thanks to Scott for the spot and doing
the research that lead to the replication of the problem. [David]

=item *

The Log page no longer improperly redirects to the preview page after a
preview. Reported by Simon Wilcox. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.6.7 (2003-10-22)

=head2 Bug Fixes

=over

=item *

Fixed C<bric_soap> to accept a C<--server> argument starting with "https",
which is more friendly to an SSI environment. [Geoff Richards]

=item *

The PostgreSQL admin username and password arguments were reversed during
C<make upgrade>. [Thorsten Biel]

=item *

Fixed broken foreign key index on element table. [Dave Rolsky]

=item *

Added partial index to speed queries against the job table, and thus to speed
distribution. [Mark]

=item *

Fixed upgrade module to properly grant the correct Bricolage database user
permission to access new tables and sequences. [David]

=item *

An upgrade script failure will I<really> now cause C<make upgrade> to halt
installation so that any issues are immediately identified and correctable.
[David]

=item *

Updated slug RegExen. They were a bit too strict, and should be better now,
allowing dots, dashes, and underscores. Spotted by Creighton Higgins. [David]

=item *

The C<$name> variable no longer shows up twice in the list of available
content variables for alert types on media documents. Thanks to Scott for the
spot! [David]

=item *

Inactive alert types no longer trigger the sending of alerts. Thanks to Scott
for the spot. [David]

=item *

Added tests for validity of the POD in F<*.pod> files as well as F<*.pm>
files. Fixed a few POD typos found as a result. [David]

=item *

Fixed C<element_data_id> parameter to
Bric::Biz::Asset::Business::Parts::Tile::Data to actually work. Reported by
Eldar Kononov. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.6.6 (2003-10-03)

=head2 New Features

=over

=item *

Added F<README.Solaris>, with thanks to Oscar Sodani and Thorsten Biel.

=back

=head2 Bug Fixes

=over

=item *

When an asset is published or deployed directly from the asset profile, it is
now properly removed from the publish or deploy desk. Reported by Andy Baio's
coworker. [David]

=item *

The "desk_id" attribute of assets is now properly cleared when an asset is
removed from workflow. [David]

=item *

Fixed 1.6.5 upgrade script to look for Bric::Config in the proper location.
[David]

=item *

Templates now display their output channel associations instead of their
element associations on desks. This seems to be more useful, since the element
association is usually obvious from the name. [David]

=item *

The category URI is now displayed for assets on desks, rather than the
name. This is consistent with the display of the category elsewhere. [David]

=item *

Elements to which no subelements can be added will no longer display an empty
select list and "Add Element" button. [Geoff Richards]

=item *

C<< Bric::Biz::Asset::Business::Story->get_secondary_categories() >> will no
longer return categories deleted from the story. Thanks to Scott for the
spot. [David]

=item *

Removed some unnecessary JavaScript validation. [David]

=item *

Bug fix when deploying to multiple output channels. If the output channel IDs
matched each other partly, it could cause a file to be removed after it just
had been uploaded. [Arthur/Fotango]

=item *

Users with CREATE access to a start desk can once again create stories on that
desk even when they don't have CREATE access to "All Stories." Reported by
Simon Wilcox. [David]

=item *

Each upgrade script is now run within the confines of a single database
transaction. If any database changes within an upgrade script encounter an
error, all of the changes in that script will be rolled back. Suggested by
Arthur. [David]

=item *

An upgrade script failure will now cause C<make upgrade> to halt installation
so that any issues are immediately identified and correctable. [David]

=item *

An invalid date in a date element field no longer causes an error. Thanks to
Arthur for the spot! [David]

=item *

With C<(STORY_URI_WITH_FILENAME> enabled and when there is no defined file
extension Bricolage now doesn't insert an ending '.' (dot). [Arthur/Fotango]

=item *

Slight fix to virtual FTP server to handle bad FTP clients that try and use
directories as files. [Arthur]

=back

=cut

##############################################################################

=head1 VERSION 1.6.5 (2003-09-10)

=head2 Bug Fixes

=over

=item *

Previewing stories with related media that have no associated file no longer
causes an error. Reported by Kevin Elliott. [David]

=item *

Switched to using C<< DBI->connect_cached() >> from using our own database
connection caching. This change does bump up the minimum required version of
DBI to 1.18, though the latest version is always recommended. It's also the
right thing to do. Thanks to Perrin Harkins for the suggestion. [David]

=item *

Fixed issue that could cause Bric::Util::DBI to create inconsistent
transaction states. Spotted by Rudy Lippan. [David]

=item *

Removed passing of DEBUG argument to C<prepare()>, C<prepare_c()> and
C<prepare_ca()>, since it hasn't actually worked in some time, and could
potentially change the behavior of the prepare. [David]

=item *

Bric::SOAP::Workflow no longer throws an error when its C<publish_date>
parameter is undefined. Reported by Kevin Elliott. [David]

=item *

Passing an undef via the C<workflow__id> parameters to the C<list()> method of
Story, Media, or Template really does again cause Bricolage to correctly
return only those assets that are not in workflow. It wasn't as fixed in 1.6.3
as I had thought. Reported by Kevin Elliott. [David]

=item *

Vastly improved the speed of the query that lists events, and added an index
to help it along, as well. [Mark]

=item *

The list of categories associated with a story is now presented in
alphabetical order by URI in the story profile. Suggested by Geoff
Richards. [David]

=item *

The FTP mover now properly deletes files rather than erroring out. [Clive
Jones]

=item *

Fixed installer to use PostgreSQL 7.1 syntax to update statistics. [David]

=item *

Now setting C<$PGDATESTYLE> environment variable so that PostgreSQL isn't
confused about the date style Bricolage is using. Suggested by Chris Riddoch.
[David]

=item *

Users without EDIT access to the start desk in a workflow can no longer create
assets in that workflow. Nor can they check out assets from the library, as
there's no start desk for them to check them in to. But they can still check
them out from other desks that they have EDIT access to. Reported by Rachel
Murray. [David]

=item *

Time zone issues have been fixed to be more portable. Some platforms that
experienced Bricolage unexpectedly shifting cover dates and other dates and
times by several hours should no longer see this problem. [David]

=item *

Non-existent methods no longer throw "permission denied" exceptions, but the
standard Perl "Can't locate object method" exception. This is to eliminate
confusion with permission to access Bricolage objects. [David]

=item *

Adding a new element type with the same name as an existing or deleted element
type no longer causes an SQL error. Thanks to Gary Gilchrist for the spot.
[David]

=back

=cut

##############################################################################

=head1 VERSION 1.6.4 (2003-08-12)

=head2 Bug Fixes

=over

=item *

Preview works again. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.6.3 (2003-08-12)

=head2 Bug Fixes

=over

=item *

Document and contributor type field information (label, options) is no longer
pushed through Locale::Maketext, thus preventing errors when element and
contributor type administrators create field options with brackets in
them. Reported by Kevin Elliott. [David]

=item *

Documents associated with categories that have been deleted will once again
work properly. Even though a category may be deactivated, any documents
previously put into that category should still work, and still treat the
category as a working category. And so they do. Thanks to Kevin Elliott for
the spot! [David]

=item *

Renamed events for adding fields to elements and contributor types. They were
mentioning "attributes," and now they mention "fields," instead. [David]

=item *

Updated Bric::Admin (F<INSTALL>) to instruct users encountering installation
problems to first check the list archives and post to the mailing list before
filing a bug. [Cinly Ooi]

=item *

Permissions granted on the "All" groups work again. Reported by Kevin Elliott.
[David]

=item *

Resize now works in super bulk edit. Thanks to Michael G. Kaiser for the spot.
[David]

=item *

Documented that the C<list_ids()> methods in Bric::Biz::Asset's subclasses
ignore the C<Order> and C<OrderDiretion> parameters and return an unordered
list of IDs. Reported by Clive Jones. [David]

=item *

The "Add Element" select list in story, media profiles now lists the fields
that can be added in the order specified in the element profile, and then the
subelements that can be added, instead of mixing up fields and subelements in
alphabetical order. Thanks to JoE<atilde>o Pedro for the spot! [David]

=item *

When a template is deployed, Bricolage now checks to see if its file name has
changed since it was last deployed, and if it has, it deletes the old
file. Reported by Kevin Elliott. [David]

=item *

Optimized performance of Bric::Dist::Resource queries and wrote lots of tests
for them. [David]

=item *

When a story or media document is published, Bricolage now looks to see if any
files distributed for previous versions of the document are no longer
associated with the document, and expires them if they are. It does so on a
per-output channel basis, so note that if output channel settings have changed
since the document was last published, the expiration may miss some stale
files. The same goes for when destinations are changed. But this should cover
the vast majority of cases.

=item *

Fixed error looking up alert types in the database, which affected the alert
type manager on some platforms. Reported by Radu Greab. [David]

=item *

Deactivated alert types are once again available via the UI. [David]

=item *

Text input fields no longer impose a default maximum field length. This is so
that element fields that have their maximum length set to 0 can truly be
unlimited in length. Reported by Kevin Elliott. [David]

=item *

Template output channel associations no longer trigger an error when importing
templates via the SOAP interface. [Clive Jones]

=item *

Passing an undef via the C<workflow__id> parameters to the C<list()> method of
Story, Media, or Template once again causes Bricolage to correctly return only
those assets that are not in workflow. Reported by Kevin Elliott. [David]

=item *

Extra blank lines between subelement tags in super bulk edit no longer causes
an error. Thanks to Kevin Elliott for the spot! [David]

=item *

Searches no longer return unexpected results or all objects when pagination is
enabled. Thanks to Kevin Elliott for the spot! [David]

=item *

The searches for documents by beginning and ending cover dates were not
inclusive of the end date. Now they are! Reported by Kevin Elliott. [David]

=item *

Fixed spelling of "contributor" in the description of the contributor type
class in the database. Noticed by Radu Greab. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.6.2 (2003-07-28)

=head2 New Features

=over

=item *

German localization started. [Gerfried Fuchs]

=item *

New help pages for the destination, server, and action profiles. [Geoff
Richards]

=back

=head2 Bug Fixes

=over

=item *

Fixed a bug in Bric::SOAP::Media which was causing all media files uploaded
with that module to be placed in C<comp/data/media/$version/> rather than
C<comp/data/media/$id/$version/>. [Mark]

=item *

Fixed SQL bug that might in rare situations cause element output channel
associations to become confused. [David]

=item *

Fixed issue where new output channels added to a document type element were
not always actually saved as a part of that element. [David]

=item *

Fixed side navigation spacer graphic to the same width as other such
graphics. Helps Chinese Traditional to display more nicely. [Kang-min Liu]

=item *

The media simple search now searches by URI again. [Mark]

=item *

Now HTML-escaping the contents of the context content displayed for
subelements so as to prevent HTML in fields from messing up the display.
[Mark]

=item *

Fixed installer to again work with versions of PostgreSQL prior to 7.3. Thanks
to Marc Hawson for the spot. [David]

=item *

Fix for 'Can't call method "out_method" on an undefined value' generated
during a burn. [Mark]

=item *

Many minor HTML corrections. [Gerfried Fuchs]

=item *

Fix for SQL error when searching for media by file name. [David]

=item *

Eliminated 'Can't locate object method "redirect" via package
"HTML::Mason::Request"' error that caused Bricolage to actually display a
generic error page, instead of its custom error page. [David]

=item *

Alert types can once again be deleted from the alert type profile. [David]

=item *

Users can now only add subelements to a story if they have at least READ
permission to those subelements. Thanks to Mark for the spot. [David]

=item *

If the installer notices that you're attempting to install Bricolage in a
directory with an existing installation, it will suggest that you consider
running C<make upgrade>, instead. Suggested by Bruce Albrecht. [David]

=item *

The list manager now sorts version numbers as numbers rather than strings.
[JoE<atilde>o Pedro]

=item *

The media type profile again allows extensions to be added and removed.
Reported by Tobias Kremer. [David]

=item *

Added the C<CHAR_SET> directive's value to Bricolage's Apache configuration
via the F<httpd.conf> directive C<AddDefaultCharset>. Might help with some
Unicode issues. [David]

=item *

Distribution error handling is better now, with errors passed back to the
client and an error when F<bric_dist_mon> attempts to connect to a server or
URL that's not a Bricolage distribution server. [David]

=item *

Eliminated installation error 'Failed to create database: parser: parse error
at or near "template0"', which occurred with versions of PostgreSQL prior to
7.3. [Scott]

=item *

Enabled the C<PERL_LOADER> F<bricolage.conf> configuration directive and gave
it a default value that's actually useful. [David]

=item *

Perl 5.8.0 or later is now strongly recommended for better Unicode support.

=item *

Fixed deleting an Alert Type Rule. Also fixed Editing Alert Type Recipients.
[Scott]

=item *

Notes are once again saved with a document. Thanks to Scott for the spot!
[David]

=item *

Fixed an issue with FTP distribution where the incorrect FTP root was used an
invalid path. [Clive Jones]

=item *

The title and description of a story or media document are now properly
reverted when the document is reverted to an earlier version. Thanks to Scott
for the spot. [David]

=item *

Pagination now works properly when searching for groups by type in the group
manager. [Scott]

=item *

Pagination now works properly when searching for elements by element type in
the element manager and when searching for contributors by contributor type in
the contributor manager. [David]

=item *

Creating a new story that has a URI that conflicts with an existing story no
longer creates an extra story. Reported by Clive Jones. [David]

=item *

Changed "Cannot publish asset because there are no Destinations associated
with its output channels" to instead include the name of the output channel
missing Destination associations so that the user can tell which output
channels need a Destination association. [Clive Jones]

=item *

When an document's primary output channel has been changed to something other
than that defined by its document type element, preview will now correctly
use the document's primary output channel instead of the element's primary
output channel. [David]

=item *

Returning to a desk from editing an asset that was selected for editing from
that desk no longer triggers an error. Thanks to Clive Jones for the spot!
[David]

=item *

An attempt to preview a story where its templates output no content no longer
results in an error. Reported by Eldar Kononov. [David]

=item *

Clicking "Cancel" in an element no longer saves the changes in that element
before going up to the parent element. Thanks to Andrew Baio for the spot!
[David]

=item *

Changes made to the default values of fields in the contributor type profile
are now properly saved. Reported by Scott. [David]

=item *

Adding Extensions to a Bric::Util::MediaType object when creating it via that
class' C<new()> constructor works again. Reported by Clive Jones. [David]

=item *

Added Localization support to widgets that were missing it. Added pt_pt
localized images. [JoE<atilde>o Pedro]

=item *

Documents are no longer distributed to deleted (deactivated) destinations.
Reported by Mark. [David]

=item *

Eliminated several error log authentication message such as "No cookie found."
This tended only to confuse users when they were just starting to use
Bricolage. I've left in a few error messages, however, so that system
administrators can see in the log when it looks like someone is trying to hack
into Bricolage. The remaining authentication error log messages are:

=over

=item *

Invalid username or password. Please try again.

=item *

User does not exist or is disabled.

=item *

Malformed cookie.

=item *

Cookie hash mismatch from [IP address] (Hostname '[hostname]') for user
'[username].'

=back

=item *

Elements added with the same name as an existing, active or inactive element
no longer trigger an SQL error to be displayed. Thanks to Clive Jones for the
spot! [David]

=item *

Fixed issue where adding an output channel to a document type element removed
that output channel from another document type element. Thanks to Clive Jones
for the spot! [David]

=item *

Adding a server to a new destination before saving the destination or adding
an action no longer causes an SQL error. [David]

=item *

C<make clone> now properly clones F<bricolage.conf>, C<httpd.conf>, and all of
the contents of F<conf/>. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.6.1 (2003-06-12)

=head2 New Features

=over

=item *

Added F<bric_xfer_grps> and F<bric_xfer_users> to F<contrib/bric_xfer>. They
use the Bric API to transfer users and groups between Bricolage Installations.
[Scott]

=item *

Added Traditional Chinese localization. [Kang-min Liu]

=back

=head2 Bug Fixes

=over

=item *

C<make clone> now properly creates F<inst/Pg.sql> instead of
F<inst/bricolage.sql>. It also once again properly resolves the circular
dependency between the "usr" table and the C<login_avail()> PostgreSQL
function. [David]

=item *

The FTP distributor now deletes existing copies of files before renaming a
temporary file when connecting to Win32 servers. This is because the IIS FTP
server doesn't seem to support renaming a file to the same name as an existing
file. [David]

=item *

Creating the database during C<make install> no longer fails if someone
is already connected to template1. [Scott]

=item *

A preview link is no longer in the "Find Media," "Active Media," desk, or "My
Workspace" views for media that have no associated file. [David]

=item *

C<make upgrade> now uses the correct PostgreSQL root username and password,
instead of the default "postgres" username and empty password. Thanks to Paul
Cory for the spot! [David]

=item *

Burn-time exceptions are once again properly displayed in the error
page. [David]

=item *

When the C<STORY_URI_WITH_FILENAME> F<bricolage.conf> directive is enabled,
stories are now written to the proper file when previewed or published. Thanks
to Kevin White for the spot! [David]

=item *

Fix issue that came up with the release of Mason 1.20. Reported by Jeff
Steele. [David]

=item *

Fixed typo in Media Type manager that broke it. Reported by Lari Huttunen.
[Scott]

=item *

Fixed problem where an attempt to add new output channels to a new element
before saving that element cause errors. Mainly noticeable when creating
elements via SOAP. Thanks to Mark for the spot. [David]

=item *

Various localization fixes. [Scott]

=item *

Fixed event logging for element fields. [David]

=item *

Media assets that are based on "Image", "Audio", and "Video" element types now
properly show up on desks. Note that existing media assets missing from desks
should be checked out via "Active Media" and moved to a new desk. [David]

=item *

Documented the support for passing C<%ARGS> to C<< $burner->display_element() >>
in templates. It was added to Bric::Util::Burner::Mason a while ago, but I
forgot to document it! Thanks to Mike Slattery for the spot. [David]

=item *

Added Crypt::SSLeay to the list of optional modules to be installed. This
module is required for SOAP communications over SSL. So if you use SSL and you
use the SOAP server, you'll want to install it. [David]

=item *

Fixed alerts so that alerts are once again sent to the members of groups.
Reported by Paul Cory. [David]

=item *

Deleted alert types are no longer displayed in the Alert Type Manager. Thanks
to Paul Cory for the spot! [David]

=item *

Added more intelligent code using HTTP headers instead of HTML to prevent
browsers [IE] from caching pages. [David]

=item *

Bricolage no correctly sets the HTTP headers for the content language and
character set. Thanks to Nathan Ollerenshaw for the spot! [David]

=item *

C<make clone> now changes the user and group ownership on the cloned files to
the values for the current user (root). This is to avoid problems when
C<tar>ing up those files. [David]

=item *

Added code to Apache configuration to force JavaScript files to be served with
the proper character set HTTP header. Those who use manual Apache configuration
along with Bric::App::ApacheStartup will want to add the following configuration
directive to your F<httpd.conf>:

  <Location /media/js>
    ForceType => "application/x-javascript; charset=utf-8"
  </Location>

=item *

The virtual FTP server no longer displays templates in subcategories of the
current subcategory directory. Thanks to George Harrison for the spot! [David]

=item *

Output channel associations in story type and media type elements can now be
deleted again. Thanks to Arthur Bergman for the spot! [David]

=item *

Added listing of emeritus developers. Otherwise Sam was simply listed as a
patcher, which is hardly accurate. [David]

=item *

The element profile no longer displays deleted fields after clicking the "Save
and Stay" button. [David]

=item *

The element profile now correctly issues a warning when a field is selected to
be deleted. [David]

=item *

Made unlocalized JavaScript message localized. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.6.0 (2003-04-29)

=head2 New Features

=over

=item *

Added the C<STORY_URI_WITH_FILENAME> F<bricolage.conf> directive, which, when
enabled, allows story URIs to include the file name. This is especially useful
in output channels where "Use Slug as File name" is enabled, since it allows
stories to essentially have identical URIs except for the file name. Off by
default. [David]

=item *

Added F<bric_media_upload>, a media file bulk import utility, into
F<contrib>. Thanks to Matt Vella for the contribution.

=item *

New help pages for the event log and the workflow trail. Thanks to Geoff
Richards for the contribution.

=item *

Some unnecessary JavaScript was removed from the side navigation layer. Thanks
to Eldar Kononov for the suggestion. [David]

=item *

Added keyword support for media assets to SOAP interface. [David]

=item *

Neatened the "Find Stories," "Active Stories," "Find Media," and "Active
Media" screens and added the ability to preview stories and media by clicking
their titles. [David]

=item *

Added Field Profile, so that element Fields can be edited. This is a marked
improvement over the old interface, which required that fields be deleted and
recreated if users wanted to change them. [Scott]


=back

=head2 Bug Fixes

=over

=item *

Granting of permission to database objects during installation has been moved
to its own make target. This is to allow it to be run by C<make upgrade>, too,
thus ensuring that the Bricolage database user always has the appropriate
permissions to access the database. [David]

=item *

Assets can once again be removed from workflow. [David]

=item *

The published version attribute is now set on templates when they're
deployed. Thanks to Geoff Richards for the spot. [David]

=item *

The F<bricolage.conf> and F<httpd.conf> files are now created during C<make>
rather than C<make install> so that C<make test> can take advantage of them.
[David]

=item *

Bric::App::Session and Bric::App::Cache no longer C<chown> their files and
directories during C<make test>. [David]

=item *

Super Bulk Edit no longer joins lines together without a space, so that words
should now be properly separated. [David]

=item *

Deleting a story or media subelement no longer results in an error. [David]

=item *

Help has been restored. [David]

=item *

A value of "0" (zero) can now be given to element fields. This bug has been in
Bricolage since the beginning! Thanks to Mark for the spot. [David]

=item *

Stories with subelements containing no field elements no longer cause an
error when the container profile is looking for contextual information to
display about a a subelement. Thanks to Chris Jantzen for the spot. [David]

=item *

Bulk editing a field without first going through the element profile and
without adding or removing or reordering field elements now preserves the
data. This is another bug that has been in the code since the beginning of
time, and was only recently identified. Thanks to Rachel Murray for the spot.
[David]

=item *

Fixed an obscure bug where an element with a field element and a container
element with the same ID could cause an error when one tries to edit the
container element and Bricolage tries to load the field element,
instead. Embarrassingly discovered in the middle of a presentation to the
London Perl M[ou]ngers. [David]

=item *

Minor JavaScript fix for Opera users, thanks to Kevin White. [David]

=item *

The "multi" installation method now defaults the "Bricolage Root Directory"
setting to F</usr/local/bricolage> instead of "NONE". This seems to be less
annoying to people. [David]

=item *

The F<inst/upgrade/1.5.1/asset_desk.pl> script, which is run by
C<make upgrade>, now correctly checks to see if the upgrade has already been
performed. [David]

=item *

The F<inst/upgrade/1.5.1/webdav_mover.pl> script, which is run by
C<make upgrade>, now correctly checks for the existence of the correct record
in the "class" table before inserting a new record. [David]

=item *

During C<make upgrade>, the upgrade scripts are now run I<before> the new APIs
are installed, so that there are no conflicts when using the existing API to
make changes. [David]

=item *

Creation and installation of man pages can now be avoided during
C<make upgrade> as well as during C<make>. [David]

=item *

Man pages will now be installed in the correct subdirectory of
C<$BRICOLAGE_ROOT> when using the "multi" install method. [David]

=item *

Fixed issue where asset groups and desk groups were conflated in workflow
objects, leading to errors on the permissions page. Thanks to JoE<atilde>o
Pedro for the spot. [David]

=item *

The URI of new stories is once again properly formed when the stories are
created. [David]

=item *

The list of events no longer displays attributes for events that have no
attributes. [David]

=item *

Attempting to add more keywords to the root category no longer results in the
error "Cannot change the directory of the root category." [David]

=item *

In lists of objects a cell with a value of "0" (zero) will now be displayed.
[David]

=item *

In "Find Templates," the list of templates in the search results will now be
sorted by the file name, instead of not at all. [David]

=item *

C<make distclean> now properly deletes F<inst/Pg.sql>. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.5.2 (2003-04-02)

=head2 New Features

=over

=item *

Out of the box, the Story Editors, Media Producers, and Template Developers
groups now have READ permission to access members of the "All Categories" and
"All Elements" groups, which allow them to actually create assets based on
elements and within categories. [David]

=item *

Workflow and Desk permissions are a little more sensible now. CREATE
permission can be granted for the start desk in each workflow, instead of for
the entire workflow. This allows a lower permission to be set on the workflow
(e.g., READ), and then higher permissions on the individual desks in the
workflow. [David]

=item *

New "Tuning" sections have been added to L<Bric::DBA>. [Mark]

=back

=head2 Bug Fixes

=over

=item *

The default required length for usernames and passwords has been changed from
6 to 5. This is to make dealing with the default "admin" login easier.

=item *

It is once again possible to delete elements when they are not associated with
any story or media asset. [David]

=item *

The output channel profile once again only complains that the name of an
output channel is already in use if it happens to be true. [David]

=item *

Bric::Config now does its best to find a workable F<httpd.conf> file during
C<make test>. [David]

=item *

Subclasses of Bric::Biz::Asset::Business::Media work again, and can have
keywords associated with them, too. [David]

=item *

The "Access Denied" message is back for when someone tries to access an object
to which they don't have adequate permission. [David]

=item *

Previews of assets that are not checked out work again. [David]

=item *

Workflow and desk permissions relative to the assets they contain are now
restored to their previous behavior. Desks no longer simply inherit the
permission granted on any of the workflows they're in. This issue was resolved
by creating a new secret asset group ID for each workflow. [David]

=item *

The primary output channel is now always enabled by default in top-level
elements. This is to make it much harder to create documents without output
channel associations, an event that can lead to database exceptions. [David]

=item *

The root category now lists itself as being in the "All Categories" group only
once in the category profile. [David]

=item *

Assets will no longer appear to randomly disappear from workflow. [David]

=item *

Added constraints to the "media_type_member" group that were inadvertently
left out of 1.5.1. [David]

=item *

Permissions are now once again properly checked for assets in categories,
workflows, and on desks. [Mark]

=back

=cut

##############################################################################

=head1 VERSION 1.5.1 (2003-03-23)

=head2 New Features

=over

=item *

Lots of group-related optimizations. These should greatly improve the speed
with which permissions are checked. [David]

=item *

Improved testing support with lots more tests. Many more remain to be
written. See the new testing documentation in L<Bric::Hacker|Bric::Hacker> for
details. [David]

=item *

Added ability to publish assets at a future time to Bric::SOAP::Workflow.
Includes addition of new C<--publish-date> option to F<bric_soap>. [David]

=item *

Added WebDAV mover. [JoE<atilde>o Pedro]

=item *

FTP and File System movers now atomically copy files to their destination
servers. [JoE<atilde>o Pedro]

=item *

Added "All Desks" group for managing the permission to access all desks.
[David]

=item *

Refactored and optimized the code used in the C<lookup()>, C<list()>,
C<list_ids()>, and, where pertinent, C<href()> methods in the following
classes:

=over

=item Bric::Biz::Asset

=item Bric::Biz::Asset::Business

=item Bric::Biz::Asset::Business::Story

=item Bric::Biz::Asset::Business::Media

=item Bric::Biz::Asset::Template

=item Bric::Biz::AssetType

=item Bric::Biz::ATType

=item Bric::Biz::Category

=item Bric::Biz::Org

=item Bric::Biz::Org::Person

=item Bric::Biz::Org::Source

=item Bric::Biz::OutputChannel

=item Bric::Biz::OutputChannel::Element

=item Bric::Biz::Person

=item Bric::Biz::Person::User

=item Bric::Biz::Workflow

=item Bric::Biz::Workflow::Parts::Desk

=item Bric::Dist::Job

=item Bric::Dist::ServerType

=item Bric::Util::AlertType

=item Bric::Util::Event

=item Bric::Util::Grp

=item Bric::Util::MediaType

=item Bric::Util::Pref

=back

This work will allow permission checking to be much faster for objects of
these classes, as the relevant group IDs are now looked up for each object
when the object is looked up, rather than by a separate select for each
object, one-at-a-time. The changes also include support for a C<grp_id>
parameter to be passed to the C<list()> method of these classes as a way of
allowing a group to return a list of the objects in the group en masse, rather
than one-at-a-time from the member objects of each group. Once similar
optimizations have been made to the Bric::Biz::Assest classes, the necessary
change will be made to Bric::Util::Grp to allow this functionality. [David and
Mark]

=item *

Added object caching to the base class, and calls to it from all classes with
a C<lookup()> method to take advantage of it. The caching is only for the
duration of a request for now, but can be expanded later. [David]

=item *

Updated F<INSTALL.MacOSX> to reflect changes thanks to the new Mac OS X
support included in libapreq 1.1. [David]

=item *

Added "Super Bulk Edit", which is a bulk edit interface allowing users to
edit all of the fields in an element at once using POD-like tags, rather than
just a single repeatable field. [Garth]

=item *

Added help topic for new "Super Bulk Edit" feature. [David]

=item *

Localization and Internationalization support introduced, with a Portuguese
library to complement the default English. Most message strings have been
replaced with calls to the proper localization method. Still to be done are
strings fetched from the database (e.g. events). [ClE<aacute>udio Valente]

=item *

Localization of text images (buttons), Help, and JavaScript message added.
These still need translation, however. [David]

=item *

Added Italian translation. [Marco Ghezzi]

=item *

Documented F<bric_dist_mon> and F<bric_ftpd>. [David]

=item *

Optimized and added tests for Bric::Util::Priv's C<get_acl()> and
C<get_acl_mtime()> methods. These should make the looking up of a user's
access control list faster. [David]

=item *

Added preview link to every element profile of a story profile. [Scott]

=item *

Pared down number of default User groups by eliminating those that relate to
only a single admin menu item. [David]

=item *

Fixed code in Bric::Util::Grp where the C<has_member()> method would fail to
look up an object with an ID of 0. [JoE<atilde>o Pedro]

=item *

Switched exceptions from home-grown to using Exception::Class. [Scott]

=item *

The installer now offers a more meaningful message when it encounters an
existing database and the user doesn't want to drop that existing database.
[David]

=item *

Added category group association, including ability to cascade membership
assignments into subcategories, to category profile. [JoE<atilde>o Pedro]

=item *

The installer will no longer try to load CPAN.pm if all modules are already
installed. Thanks to Ilia Chipitsine for the prodding. [David]

=item *

The "Content" section of story, media, and subelement profiles now attempts to
display a bit of text from the first text field in each listed subelement so
that it's easier to see at a glance which subelement is which. [JoE<atilde>o
Pedro]

=item *

Switched POD testing from Pod::Checker to Test::Pod (using Pod::Simple). Fixed
the POD errors it found, too. [David]

=item *

Test suite now runs all tests with warnings enabled. [David]

=item *

Modified C<< Grp->get_objects() >> to use use the C<grp_id> parameter to
C<list()>, now that support for that parameter has been added to all groupable
classes. Also went through all existing code to make sure that it uses this
approach, rather than constructing the relevant objects one-at-a-time from
each Member object. This should provide a dramatic speedup in many
operations.

=item *

Bric::App::Session now has an C<instance()> public class method to return the
current C<%session> hash. [Scott]

=item *

Subelements can now nest. That is, they can contain themselves. Not in a story,
of course, but in the document model (element administration). [David]

=item *

Keywords can now be associated with media assets. [David]

=item *

Templates now have a C<published_version> attribute that properly reflects the
version of a template that was last deployed. This matches what Story and
Media have done since around version 1.3.2, and eliminates some warnings from
the error log. The UI has also been updated to properly show the deploy status
of templates. [David]

=item *

The installer should now properly detect that the Apache "log_config" module
is installed even when it's called "config_log". Thanks to Ilia Chipitsine for
the spot and the diagnostics needed to solve the problem. [David]

=back

=head2 Bug Fixes

=over

=item *

The publish attribute of desks can now be unset. Thanks to Sean Greathouse for
the catch! [David]

=item *

Fixed asset class date parameters to list(). The asset classes were neglecting
to change the dates passed in to list() to database dates before querying the
database. This lead to the wrong stories being returned for everyone not using
UTC as their local time zone. Thanks to Bill Cappel for the spot! [David]

=item *

Fixed bug where expired cookie resulted in a Bric::App::Session
error. [JoE<atilde>o Pedro]

=item *

A number of default groups where not properly added to the "All Groups"
group. Now they are. [David]

=item *

Bricolage now does more to determine the media type of uploaded media by using
both the Apache media type determination and, failing that, a file name
extension. Thanks to Todd Tyree for the spot. [David]

=item *

Fixed the description of the root category in the permissions profile for user
groups so that it properly displays its URI instead of its name. This only
affects the display of the root category in the permissions profile for people
who installed (rather than upgraded to) Bricolage 1.4.5 or later. [David]

=item *

An attempt to create a template with the same name and output channel as a
deactivated template now properly tells the user that the template already
exists. [David]

=item *

Fixed indexes for person objects so that they're case-insensitive. [David]

=item *

Fixed problem creating new business assets with SOAP where Bricolage was
trying to associate them with output channels twice, resulting in an SQL
Error. [David]

=item *

Fixed broken index on media type extensions. It was duplicating the index on
the media type names. It has been changed to uniquely index the media type
file name extensions. [David]

=item *

C<< Bric::Biz::Category->get_children >> now properly returns the children for
the root category. Thanks to Sam for the spot! [David]

=item *

Removed C<< Bric::Biz::AssetType->remove >>. It shouldn't be used anywhere,
and might be responsible for the mysterious disappearance of elements in
general. Thanks to JoE<atilde>o Pedro for the spot. [David]

=item *

Assigned appropriate permissions to allow the default "Story Editors," "Media
Producers," and "Template Developers" to access the default workflow and desks
relevant to them. They hadn't had that access by default before. [David]

=item *

Changed the plural name of the "Category Group" class from "Category Group" to
"Category Groups". [David]

=item *

Fixed bug introduced in 1.5.0 where stories where checked for duplicate URIs
for output channels that they weren't actually in. Thanks to Bill Cappel for
the spot. [David]

=item *

Fixed duplicate URI checking for media assets so that all output channels a
media asset is in will be checked for duplicate URIs instead of just the
primary URI. [David]

=item *

Fixed bug where all sources were being deactivated from their groups every
time they were saved. [David]

=item *

Fixed bug where the SOAP server would throw an exception when it attempted to
handle elements without subelements. Thanks to Sam Tregar for the report.
[David]

=item *

It is no longer possible to create a story type or media type element without
a primary output channel. [David]

=item *

Deleted output channels no longer show up in the list of output channels to
associate with a destination. Thanks to Alex Epshteyn for the spot! [David]

=item *

The installer now collects Apache configuration data from any C<Include>d
files, as well. Thanks to Alex Wheeler for the spot! [David]

=item *

Media types now can be added to groups. This means that permissions can be set
so that users can administer media types. Previously, only members of the
"Global Admins" group could administer media types. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.5.0 (2003-01-09)

=head2 New Features

=over

=item *

Added unit testing framework based on L<Test::Class|Test::Class> and executed
by L<Test::Harness|Test::Harness>. Tests can be run after C<make install> by
running C<make test> or C<make devtest>. The former runs tests that access
database data but execute no C<INSERT>, C<UPDATE>, or C<DELETE> commands. The
latter runs tests that can make changes to the database, and are intended to be
a full testing of Bricolage's API. Both make targets can be executed in
verbose mode by passing C<TEST_VERBOSE=1> to the make command. From now on,
all tests will be expected to pass before changes are committed to the
repository. [David]

=item *

Added F<Makefile.PL>. This is mainly a dummy script designed to mimic the
usual way in which Perl modules are installed. It doesn't actually create a
F<Makefile>, but processes the existing one, setting it up to use whatever
Perl was used to execute F<Makefile.PL> itself. The advantage to this is that
the Perl that executes F<Makefile.PL> will be used throughout Bricolage. [David]

=item *

Migrated tests in F<lib/Bric/Util/Grp.pl> to F<t/lib/Bric/Util/Grp/Test.pm>
and F<t/lib/Bric/Util/Grp/DevTest.pm>. [David]

=item *

Added F<t/Bric/Test/PodTest.pm>, which uses L<Pod::Checker|Pod::Checker> to
examine the POD in all the Bricolage modules, scripts, and test modules and
report errors. Currently, all the errors are "TODO" tests, which means that,
technically, they'll pass. But as soon as all existing POD errors are cleaned
out, errors will turn into test failures. This will help us to keep all of our
POD valid. These tests run as a part of C<make devtest>. [David]

=item *

Removed all old-style test scripts. Their contents have been copied into new
unit testing classes. These classes each execute a single test, and the old
testing contents are at the end of the file, after the C<__END__> symbol. Thus
we'll be able to use the old tests to write the new tests. [David]

=item *

Added documentation on merging CVS branches to
L<Bric::Hacker|Bric::Hacker>. [David]

=item *

Removed the URI Format and URI Case preferences and put them into Output
Channel objects, instead. They are now output channel-specific. [David]

=item *

URI format and URI case settings now properly format the URIs of media
objects, too. [David]

=item *

The slug can now be used in the Fixed URI Format. [David]

=item *

The slug can now be used for story file names. The option is supported on an
output channel basis, and will only work for stories that have a slug. [David]

=item *

Added a "and Shelve" option to the "Check In" select list in the button bar on
story, media, and asset pages. When this option is selected, the asset is
checked in and then removed from workflow without publishing. [David]

=item *

Removed the "Checkin/Publish" and "Checkin/Deploy" buttons in asset profiles
and replaced them with new "and Publish" or "and Deploy" options in the "Check
In" select list in the button bar. Doing this collects all the usual Check In
actions in one place and saves us screen real estate! [David]

=item *

Changed the way the "Checkin and Publish" and "Checkin and Deploy" callbacks
work to use existing code in the desk and publish widgets to do the dirty
work. This greatly reduces code duplication. [David]

=item *

Created a new class,
L<Bric::Biz::OutputChannel::Element|Bric::Biz::OutputChannel::Element>, which
is a subclass of L<Bric::Biz::OutputChannel|Bric::Biz::OutputChannel>. This
new class better manages the mapping of output channels to elements than the
old approach did. It also adds a new property, C<enabled>, which will be put
to use shortly. [David]

=item *

Replaced all the custom handling of output channel objects in
L<Bric::Biz::AssetType|Bric::Biz::AssetType> with a new
L<Bric::Util::Coll|Bric::Util::Coll> subclass that does it all. This is a lot
more efficient in terms of programmer time (and probably performance,
too). [David]

=item *

Modified Bric::Biz::Asset::Business to manage the association between business
assets and output channels by making use of the
Bric::Util::Coll::OutputChannel class. It also automatically adds all of the
"enabled" output channels of the element object as initial output channel
associations for new business assets. [David]

=item *

Added a new property to templates: template types. This property can have one
of three value that correspond to different template types: "Element
Templates" (those associated with elements); Category Templates" (autohandlers
in Mason parlance, category templates to HTML::Template users, and until now
"generic templates" in the UI); and "Utility Templates" (those not associated
with anything, but can be used as includes). [David]

=item *

Templates are now guaranteed to have unique file name/output channel
combinations at the API and database levels. [David]

=item *

For stories on My Workspace, replaced "Trail" with "Clone". Clicking this link
will make an exact copy of the story with the words "Clone of " prepended to
the story title. [David]

=item *

Got rid of the popup window. Now when the toolbar-less window isn't the
current window, the browser will be redirected to a a Welcome page where users
can click a link to open the new window with the Bricolage UI. [David]

=item *

Improved the interface for the association of output channels in Element
Profile. It now uses a list of output channels rather than a double list, and
a radio button to select the primary output channel. Also, each associated
output channel can be marked as "Enabled" or not, indicating whether a new
asset based on the element will by default be associated with that output
channel for publishing. [David]

=item *

On a related note, Stories and Media can now select which output channels to
be published to on a per-story basis as well as which is the primary output
channel, and the selection sticks with each version of a an asset. The list of
available output channels comes from the output channels associated with the
element on which the story or media asset is based. [David]

=item *

Bric::Util::Burner objects have a new property, C<mode>. This property
contains an integer value indicating whether a burner object is currently
publishing, previewing, or checking syntax. The value maps to the
conveniently-named constants "PUBLISH_MODE", "PREVIEW_MODE", and
"SYNTAX_MODE". [David]

=item *

The documentation in the Bric::Util::Burner class has been updated and
improved. [David]

=item *

Arguments can now be passed to the C<display_pages()>, C<display_element()>,
and C<chain_next()> methods of the C<$burner> object in Mason templates. These
arguments are passed to the templates that are executed just as they are if
you'd called C<< $m->comp >>, meaning that you can access their values via the
C<%ARGS> global and in C<< <%args> >> blocks in Mason templates. [David]

=item *

Changed the C<display_pages()> method of Bric::Util::Burner::Mason so that its
first argument can be an anonymous array of the names of different paginated
elements, and then all of those different paginated elements will be burned in
order. This allows a story to have more than one type of paginated
element. [David]

=item *

Added the methods C<prev_page_file()>, C<prev_page_uri()>,
C<next_page_file()>, and C<next_page_uri()> to Bric::Util::Burner. These
methods return the strings representing the file names or URIs of the previous
and next pages of a story, relative to the page that is currently being
burned and, in the case of the C<*_uri()> methods, appropriate to the
currently-burning Output Channel. Also updated the
L<Bric::Templates|Bric::Templates> and
L<Bric::AdvTemplates|Bric::AdvTemplates> documents to reflect these
additions. [David]

=item *

Added C<source__id> to list of criteria by which stories can be searched via
the Bric::Biz::Asset::Business::Story C<list()> and C<list_ids()>
methods. [David]

=item *

The Bricolage CSS document is now a static file served by Apache rather than a
Mason component processed by mod_perl. This allows the style sheet to be
cached by the browser so that it doesn't have to request it for every page in
Bricolage. It also cuts down on processing time, since it doesn't have to be
managed dynamically as a Mason component anymore. Also, all font sizes are now
specified in pixels instead of points, in order to maximize the consistency of
cross-browser font rendering. [David]

=item *

Added a new style for the template profile, so that template code is now
displayed in its textarea box in a monospaced font. [David]

=item *

The main Bricolage JavaScript library has had several other JavaScript
libraries rolled into it, and is now a static file served by Apache rather
than a Mason component processed by mod_perl. This allows the JS to be cached
by the browser so that it doesn't have to request it for every page in
Bricolage. It also cuts down on processing time, since it doesn't have to be
managed dynamically as a Mason component anymore. [David]

=item *

Added F<bricolage.conf> directive "ALLOW_WORKFLOW_TRANSFER" to allow assets on
shared desks to be able to be transferred across workflows via that shared
desk. [David]

=item *

Changed Bric::Util::Burner to set C<publish_status> after publishing, rather
than before. Thus it is only set if the publish is successful, while at the
same time templates can check C<publish_status> to determine if a story is
being published for the first time. [David]

=item *

Added C<get_more_pages()> method to Bric::Util::Burner::Mason. It returns true
if more pages remain to be burned, and false if not. However it's only
enumerated when C<display_pages()> is being used to output pages. [David]

=item *

Optimized Bric::Biz::Category to get a list of Group IDs for each category as
it is selected from the database. This prevents the C<get_grp_ids()> method
from having to query the database, which was happening for every category
object for which permissions are checked. [Mark & David]

=item *

Added event logging for keywords. [David]

=item *

Changed the code in Bric::Util::Burner::Mason to allow for new Mason burners
to be constructed and used to publish stories from within templates. This is
useful for generating tables of contents and such. [David]

=item *

Added support for the association between business assets and output channels
to the SOAP interface. [David]

=item *

Removed IO::String dependence. [Scott]

=item *

Added a FAQ. [Scott]

=item *

Added a preference for naming the Bricolage instance. [Scott]

=item *

Added search by Category URI to Find Stories. Although one could use the
search by URI feature for this before, it didn't allow for search by secondary
categories. Now stories can be searched for in both primary and secondary
categories. [David]

=item *

Added the methods C<page_file()> and C<page_uri()> to Bric::Util::Burner. When
passed a page number argument, these methods return the strings representing
the file names or URIs of the given page in the currently-burning story and, in
the case of the C<page_uri()> method, appropriate to the currently-burning
Output Channel. These methods are best used in burners that don't burn one
page at a time, such as Burner::Template. [David]

=item *

Ported to HTML::Mason versions 1.15 and higher. [Scott]

=item *

Added C<make uninstall> support to installation system. [Scott]

=item *

Added C<page_filepath()> method to Bric::Util::Burner. This method allows
burner subclasses to get the name of a file to write to the file system
without needing to figure out the file name themselves. [David]

=item *

Optimized behavior of collections (internal API). Now when an object is
deleted from a collection (for example, when a member is deleted from a
group), all the existing objects in the collection won't first be looked up in
the database. The upshot is that certain parts of Bricolage that rely on
collections, such as desks, should be more responsive. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.4.6 (2003-01-06)

=head2 Bug Fixes

=over

=item *

Bric::SAOP::Handler now properly logs fatal errors that are strings rather than
exceptions. [David]

=item *

Updated Bric::DBA documentation to better reflect PostgreSQL standards.
[Neil Conway]

=item *

Minor documentation correction in Bric::Util::Grp::Parts::Member. [Mark]

=item *

Fixed bug in SOAP interface where container subelements added to a story or
media asset were logged as if the story type element or media type element was
added instead of the appropriate subelement. [David]

=item *

Fixed bug in publish code that was attempting to use the Apache request object
as a media asset. Thanks to John Greene for the spot. [David]

=item *

Fixed bug where an empty or non-numeric <size> element in an imported
media object would cause an SQL error. [Sam]

=item *

The F<bric_apachectl>, F<bric_clean_tmp>, F<bric_dist_mon>, and F<bric_ftpd>
scripts are now smarter about loading Bricolage libraries and reporting
relevant errors when they can't load Bricolage libraries. Thanks to Geoff
Richards for the patch. [David]

=item *

Category permissions are now properly checked on assets when they're not in
workflow as well as when they are in workflow. This means that if a group of
users is granted permission to access stories in a category, they can now
access those stories even if they're not in workflow. [David]

=item *

The search interface for locating media and story assets to relate to a story
now checks the permissions of the assets found and only displays the assets
for which the user has at least READ permission. Thanks to Sean Greathouse for
the spot. [David]

=item *

Reverting a media asset now properly reverts the media file itself, as well.
[David]

=item *

The "Last" field is now properly highlighted as the default order field when
displaying a list of contributors in the Contributor Manager. [David]

=item *

Contributor Association now includes search options and only
currently-associated contributors are displayed before searching. [David]

=item *

The ability to select different fields by which to sort a list of objects now
works again. [David]

=item *

The installer now checks to make sure that mod_perl is statically compiled
into Apache, since weird things tend to happen when Bricolage uses a DSO
mod_perl. [David]

=item *

Fixed reordering code for subelements. The select list for subelements should
now always have an appropriate value. [David]

=item *

The URI is now properly updated in media assets when some part of the URI is
changed in the UI. Thanks to Sean Greathouse for the spot. [David]

=item *

The Add More widget no longer throws an exception when "Add More" is clicked
and only one field currently exists. This had affected Keywords entry in
stories. Thanks to Sam for the spot. [David]

=item *

Fixed bug where a user could create two assets with the same URI as long as
they were both checked out by that user. Thanks to Shannon Brown for the spot!
[David]

=item *

Date fields can now be unset. That is, if each of the select fields is set to
its label, rather than a value, it'll stay that way. This was first noticed
with the "Expire Date" in stories. Thanks to Philip Fibiger for the spot.
[David]

=item *

Modified installation C<CREATE DATABASE> command to always create the database
with the encoding set to UTF-8 (UNICODE). [David]

=item *

Added instructions for installing readline library to README.MacOSX. [David]

=item *

Fixed some inaccurate image sizes. [Geoff Richards]

=item *

Added missing C<uri> parameter to the possible search options in
C<< Bric::SOAP::Category->list_ids >>. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.4.5 (2002-11-13)

=head2 Changes

=over

=item *

Categories are now displayed by their URIs instead of their names wherever
possible. [David]

=item *

Added "Order" and "OrderDirection" parameters to C<< Bric::Util::Grp->list >>
in order to be able to specify a different column and sort order for getting a
list of groups. [David]

=item *

Improved error handling by the SOAP server. Full errors will now be printed to
the Apache error log, error messages sent back to the client are properly
escaped, and all database transactions for a single request will be rolled
back in the event of an error. [David]

=back

=head2 Bug Fixes

=over

=item *

Fixed error message generated from Bric::SOAP::Template->update() to
properly display the category name, rather than "ARRAY(0x9cf43bc)". [Sam]

=item *

The Bricolage SOAP interface will no longer allow the creation of
stories and media with duplicate URIs. [Sam]

=item *

Fixed circular dependency issues when Bricolage modules are used in the
C<PERL_LOADER> F<bricolage.conf> directive. [David]

=item *

Added the root category to the "All Categories" group. It should have been in
that group all along. [David]

=item *

Documentation for C<< Bric::Biz::Workflow->list >> has been improved, and the
method used for finding workflows and desks to put imported assets on in
Bric::SOAP has been simplified. [David]

=item *

Added printing of a message regarding the filenames being processed by
F<bric_soap>'s C<create> and C<update> commands when its C<--verbose> option
is set. [David]

=item *

Setting a story's cover date to a date that causes one of its URIs to conflict
with an existing story's URIs no longer causes an error. Thanks to Sam for the
spot! [David]

=item *

Display of the source was missing from the view Story and Media profiles, but
no longer. [David]

=item *

The correct source is now displayed in the Story and Media edit profiles.
[David]

=item *

An attempt to install Bricolage to use an existing PostgreSQL user no longer
causes an installation error when you decline drop the user. [David]

=item *

The burner no longer fails when it publishes an asset that's not on a
desk. [David]

=item *

SOAP now does the proper thing when deleting assets, removing them from desks
and workflow only if they're on desks and in workflow. [David]

=item *

Added support for the missing C<publish_status> parameter to
C<< Bric::Biz::Asset::Business::Media->list >>. [David]

=item *

Setting permissions on the assets in a category works again. [David]

=item *

Fixed a bug where exporting a story via SOAP containing a date field
would output the formatted date rather than the expected ISO 8601
format.  Systems with a modified date format pref would then refuse to
accept the story on import, producing an "Unable to unpack date"
error. [Sam]

=item *

Stories, media, and templates created but not saved no longer disappear into
the void. They are instead moved into workflow, put on a desk, and saved as
soon as they were created. [David]

=item *

Permissions are now properly checked for category and workflow settings when
new stories, media, and template assets are created. [David]

=item *

New templates are now active by default. [David]

=item *

Fixed bug where the "Checkin/Publish" (and "Checkin/Deploy") button wasn't
provided to users who had EDIT access to a the assets on a desk. Permissions
are now properly checked and the button displayed for those who can publish
from a desk. [David]

=item *

Added missing debugging statement to Bric::Util::DBI. Thanks to Mark for the
spot. [David]

=item *

The SOAP interface now properly logs events for its activities. [David]

=item *

Previewing a story while searching for a related story to link to an element
no longer replaces the Bricolage UI with the preview, as was happening with
some browsers. Instead, a separate preview window is opened. [David]

=item *

When publishing a media asset, its name will not be properly added to the UI
message, without causing an error. [Petar Bojkov]

=item *

Fixed exception class name in Handler.pm. [Scott]

=item *

Fixed installation system bug caused by inst/conf.pl loading
Bric::Config during "make install".  Thanks to Louis Moore for the
report. [Sam]

=item *

Added missing C<list_ids()> method to Bric::Biz::Category. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.4.4 (2002-10-27)

=head2 Bug Fixes

=over

=item *

Empty listManager lists no longer have a gap in them. [David]

=item *

Made the table around the formBuilder radio buttons prettier. [David]

=item *

Fixed numbering of sections in Media profile so that the numbers don't
skip. [David]

=item *

Updated display of existing contributors in the "Edit Contributors" screen of
the story and media asset profiles to use listManager. This makes them look
like they do everywhere else (and uses less code, to boot!). [David]

=item *

Improved error messages thrown in exceptions in Bric::Util::Trans::FTP.
[David]

=item *

Removed code and documentation for PostgreSQL 7.3 compatibility. With the
release of 7.3b2, it's no longer needed. [David]

=item *

Fixed "make clone" to properly include database contents in clone
distribution. [Sam]

=item *

Added C<< <meta http-equiv="Content-Type"> >> tag to the C<< <head> >> to
F<header.mc> so that the browser knows to send text back to Bricolage in the
expected character set. [Mark]

=item *

Changed the default character set from ISO-8859-1 to UTF-8. With this setting,
Bricolage does no character set translation, so it's faster. Furthermore, most
users I<should> be outputting UTF-8 in their templates, anyway. If you're not,
then you're likely finding doing charset translation in all of your templates
to be a big PITA. And if you're not doing charset translation, then you really
I<are> outputting UTF-8 in your templates, and just haven't realized it.
[David]

=item *

Fixed bug when reverting stories and media with no associated contributors.
[Mark]

=item *

"Check In and Publish" now works again for Media assets. Thanks to Matt Vella
for the spot. [David]

=item *

Deleting assets on My Workspace now prompts the user to make sure s/he really
wants to do that. Not sure how we missed this all this time! Thanks to Andrew
Baio for the spot. [David]

=item *

Assets on Desks and My Workspace that are checked out to the the user whose
viewing them will now always preview the version as currently edited by the
user, rather than the last checked-in version. Other users still can only
preview the last checked-in version. [David]

=item *

Clicking the "Check In" or "Check In/Deploy" buttons in a template profile now
properly updates the template with any new data entered into the template
profile before attempting a syntax check. This ensures that the latest data
you've entered gets its syntax checked before the template is checked in or
deployed. [David]

=item *

Fixed a bug in Bric::Util::Class where classes couldn't be looked up by
package name. This affected the "Access Denied" page. [David]

=item *

Made Bric::Util::Burner::Mason a little smarter handling exceptions. [David]

=item *

Fixed bug where Bric::SOAP::Category would fail to import ad strings. [David]

=item *

Fixed bug in C<< Bric::Util::Grp->has_member >> where an already-added member
wasn't always found. [Mark]

=item *

Conflicting URI messages for media assets no longer suggest changing the value
of the slug, since media assets have no slug. [David]

=item *

The friendly messages confirming publishes are back. [David]

=item *

Fixed bug where selecting a large number of list options in the story profile
would cause an SQL error. [Matt]

=item *

Fixed bug where Bric::SOAP would accept story element types for media and vice
versa. Thanks to Evan Prodromou for the spot. [Sam]

=item *

Added code to installation scripts to delete existing Mason object files when
upgrading. This hasn't been a problem thus far, but this step will help to
ensure that users are always running the latest UI components. [David]

=item *

Fixed bug where deactivated element types weren't checked before creating a
new element type with the same name as a deactivated element type. Thanks to
Geoff Richards for the spot. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.4.3 (2002-09-28)

=head2 Bug Fixes

=over

=item *

Fixed inconsistency between container element methods and their convenience
accessors in Bric::Biz::Asset::Business. Thanks to Philip Fibiger for the
spot. [David]

=item *

Assets can once again be recalled from the library and put on a desk. [David]

=item *

The C<get_all_keywords()> method of Bric::Biz::Asset::Business works
again. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.4.2 (2002-09-27)

=head2 Bug Fixes

=over

=item *

Can once again check out multiple assets at once. Thanks to Andrew Baio for
the spot. [David]

=item *

Templates once again behave themselves. There were some circumstances where
they couldn't be checked in, generating "Cannot checkin non checked out
versions" errors. These have been fixed. [David]

=item *

Some assets on My Workspace were getting "Cannot checkin non checked out
versions" errors when they were checked in using the "Check in to" select
list. This has been fixed. [David]

=item *

When templates are deployed, they now get a "Template removed from Workflow"
event logged. [David]

=item *

Using the "Check in to" select list on My Workspace to check assets into the
desk they're already on will no longer remove them from all desks
altogether. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.4.1 (2002-09-25)

=head2 Bug Fixes

=over

=item *

Upgrading from from a version prior to 1.3.3 no longer tries to create an
index that already exists (and that will be dropped, anyway). [David]

=item *

Removed documentation for installing mod_proxy with Apache. [David]

=item *

Improved documentation for upgrading from older versions of Bricolage that
were not installed by C<make install>. Thanks to Andrew Baio for helping to
identify the problems. [David]

=item *

Added C<use Bric::Util::Grp::Keyword;> back into Bric::Biz::Keyword. This
prevents some upgraded Bricolage installations from breaking. [David]

=item *

Added Net::FTPServer and Net::SFTP to the list of optional modules. [David]

=item *

Fixed some SQL errors uncovered by the release of PostgreSQL 7.3b1. [David]

=item *

Added code and documentation for compatibility with PostgreSQL 7.3. [David]

=item *

Media assets can now be distributed to more than one output channel at a
time. [David]

=item *

Files are now distributed on a per-output channel basis, to ensure that the
proper file is distributed to the proper destinations. [David]

=item *

Assets are now properly removed from workflow when they're deactivated
(deleted in the UI). [David]

=item *

Template syntax is now properly checked when using the "Checkin/Deploy"
button. [JoE<atilde>o Pedro]

=item *

The example generic template (autohandler) included in the database is now
included in the burn root, too, since it's marked as "Deployed" in the
database. [David]

=item *

Deleted output channels no longer show up in the "New Template" output channel
select list. Thanks to Daniel Fisher for the spot. [David]

=item *

The root category ("/") no longer returns itself as its own parent. [David]

=item *

Assets not in workflow are now properly logged as being checked out when
someone checks them out. [David]

=item *

The "Or Pick a Type" menus in the Group manager, the Contributor manager, and
the Element manager all work again. [David]

=item *

Changing category names now updates the name of the category asset group
object, which appears in the user group permissions page. [David]

=item *

Hitting the "enter" key after filling in a search field now properly submits
the search as if the "Search" button had been clicked. [David]

=item *

Changed libapreq requirement in Bric::Admin to read "Apache::Request
1.0". This should make the installer install the most recent version of
libapreq, instead of relying on whatever the OS provides. [David]

=item *

Changed value of autopopulated media asset data fields to an empty string when
the value returned by the autopopulation method is C<undef>. [David]

=item *

Fixed bug where autopopulated media asset data fields weren't properly
autopopulated. [David]

=item *

Fixed problem with category upgrade script failing on category data
created with 1.3.2. [Sam]

=item *

During installation, entering a directory name when prompted for the "PID File
Location" now results in Bricolage using a file called "httpd.pid" in that
directory, rather than trying (and failing) to use the directory itself as the
PID file. [David]

=item *

The side navigation layer is now better aware of its context, and changes the
colors of some of its graphics depending on the context. Also recreated the
"WORKFLOW" tab graphics. It looks like this has been broken for over a year,
and I only just noticed it! [David]

=item *

Slightly improved handling of assets that have forgotten where they
are. [David]

=item *

Checked-out templates are now displayed only once (instead of twice) in the
"Find Templates" manager. [David]

=item *

Added C<get_new_objs()> method to Bric::Util::Coll so that Bric::Util::Grp's
C<has_member()> method can see a member even if it hasn't been saved to the
database. Also changed Bric::Util::Grp to check for members in this way, of
course. [David]

=item *

Assets retrieved from the library now appear on the desk they're checked out
into only once (instead of twice). This thanks to the above-noted changes to
Bric::Util::Grp. [David]

=item *

Added upgrade script F<inst/upgrade/1.4.1/clean_desks.pl> to clean up existing
duplicate listings of assets on desks. [David]

=item *

Removed the C<checkin()> method from Bric::Biz::Asset::Template and
Bric::Biz::Asset::Business and put it into Bric::Biz::Asset, instead, since
it's exactly the same for all assets. [David]

=item *

Fixed the display of permissions settings to be more consistent with the
design and layout of the rest of the application. Also neatened listManager
display a bit. [David]

=item *

Fixed misnamed database constraint. [David]

=item *

Templates can once again be retrieved from the library and checked out for
revising. [David]

=item *

Assets on a desk now no longer have the current desk listed in the "Move to"
select list. Even if they did, selecting the current desk would no longer
remove an asset from workflow! Thanks to Andrew Baio for the spot. [David]

=item *

The installer is now much more intelligent about prompting for SSL
information. It won't ask if you want to use SSL if it can't find mod_ssl or
apache_ssl, and will only prompt you to pick one or the other if it can find
both. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.4.0 (2002-09-02)

=head2 New Features

=over

=item *

Fetching objects from Bric::Biz::Asset::Business::Media has been optimized for
greater speed. [JoE<atilde>o Pedro]

=item *

PostgreSQL "NOTICE" messages are now suppressed during installation. Instead,
a series of dots will be displayed to indicate progress loading the
database. [David]

=item *

Added README.MacOSX. [David]

=item *

You can now pass a date format string argument to the C<get_data()> method of
container elements in templates (and elsewhere, for that matter). This is
useful if the data you're retrieving is of the "date" type, and you don't want
the date to be formatted in the format specified in the "Date Format"
preference. [David]

=back

=head2 Bug Fixes

=over

=item *

The Element Type manager now displays properly again without errors. [David]

=item *

Assets are now properly removed from desks when they are published or moved
from one desk to another. More generally, any time a single object is removed
from a group, it will be properly removed. [David]

=item *

Media profile now display the proper category in the Category select
list. [David]

=item *

Media assets with no associated media file now generate a message indicating
that no file will be distributed, and are properly removed from workflow when
published. [David]

=item *

Some media asset events weren't getting logged properly Now they are. [David]

=item *

Database transactions are now properly maintained when publishing
assets. Everything was working, but DBI C<AutoCommit> was getting turned on,
and this likely slowed some things down a bit. [David]

=item *

Assets can once again be found via the "Find" pages and recalled into a
workflow without error. [David]

=item *

Module man pages are now properly installed under Perl 5.8.0. Thanks to
Michael Schwern for helping to diagnose the problem and come up with a
solution. [David]

=item *

The select list of desks to transfer an asset to on My Workspace now includes
all possible desks, including the one for which there is a link. [JoE<atilde>o
Pedro]

=item *

All Bricolage F<.pod> files are now installed and converted to C<man> pages
along with all of the F<.pm> files. [David]

=item *

Corrected a bunch of spelling errors in this file. [David]

=item *

Calling C<get_data()> on a container element in templates (or elsewhere, for
that matter) now properly ignores container subelements. Likewise for
C<get_container()>, which how properly ignores data subelements. [David]

=item *

All of the F<.pl> and F<.tst> files in F<lib/> no longer clutter up the
distribution created by C<make dist>. [David]

=item *

Much of the POD documentation in the API classes has been cleaned up, and
converting them to man pages no longer generates any error messages. [David]

=item *

The install process will now find Apache modules in
/usr/lib/apache/modules, which is where they are in OpenBSD. Thanks to
Mark Johnson for his help tracking this one down.  [Sam]

=item *

The install process will no longer install an incompatible version of
HTML::Mason (>1.09). [Sam]

=item *

The F<bric_dist_mon> program works again. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.3.3 (2002-08-24)

=head2 New Features

=over

=item *

Revised Bric::Biz::Keyword implementation to improve performance. The new
implementation no longer relies on the Bric::Util::Grp system. Also
implemented API and database support for Media keywords. [Sam]

=item *

Added support for search Media by category and file name through the SOAP
interface and standard API. [Sam]

=item *

Added new C<--save-cookie-file> and C<--use-cookie-file> options to
F<bric_soap> to allow authentication to span F<bric_soap> calls. This can
result in significant time savings across multiple invocations. [Matt]

=item *

Added new C<--chunks> option to the F<bric_soap> tool to avoid problems with
timeouts on large workloads. Currently only supports the workflow commands
(C<publish>, C<deploy>, C<checkin>, C<checkout>, C<move>), but it will be
expanded to other long-running commands in the future. [Sam]

=item *

Improved performance of search paging. ListManager now only builds the output
rows that will actually be shown on the screen. For large data sets this
results in a huge gain in search speed. [Adam and Sam]

=item *

Revised category implementation to use explicit C<uri> and C<parent_id> fields
rather than relying on the Bric::Util::Grp system. This improves performance
tremendously for larger numbers of categories. [Jeff Pinyan]

=item *

Added new C<--continue-on-errors> option to F<bric_soap> to prevent non-fatal
errors from ending the process. [Sam]

=item *

Beautified the list paging interface. [David]

=item *

Added new Media Type manager. [Scott]

=item *

Added list reverse feature. [Scott]

=item *

Added SFTP mover. [Scott]

=item *

Add support for Apache-SSL. This required a change to the context of the
F<bricolage.conf> C<ENABLE_SSL> directive to indicate the type of SSL support:
none, apache_ssl, or mod_ssl. [Michael Robinton]

=item *

Added support for manual httpd configuration. Split out dynamic configuration
from ApacheConfig.pm and move to a new module, ApacheStartup.pm, that sets no
Apache configuration directives. ApacheConfig.pm calls this module. [Michael
Robinton]

=item *

Added F<bricolage.conf> configuration directive to force the start up process
to always write out a F<C<$TEMP_DIR>/bricolage/bric_httpd.conf> as an
F<httpd.conf> include file. [Michael Robinton]

=item *

Moved SSL key and certificate configuration from global F<httpd.conf> settings
to per virtual host via F<bricolage.conf> configuration directives. [Michael
Robinton]

=item *

Added a C<bricolage.conf> directive to force the user to always use SSL.
[Michael Robinton]

=item *

Added C<get_data()> method to Bric::Util::Grp::Parts::Member::Contrib. This
method takes a simpler scalar argument and returns the relevant attribute.
This bit of syntactic sugar makes contributor objects behave a bit more like
C<$element> objects in templates, thus simplifying things for template
developers. [David]

=item *

Categories now default to sorting by URI, and the URI is the searchable field,
rather than name. [David]

=item *

Vastly improved the speed at which categories can be imported via SOAP.
[David]

=item *

Makefile now confirms location of Apache and PostgreSQL to allow for
systems with multiple versions of each available. [Sam]

=item *

Added "make clone" command to the installation system to create
distributions based on existing Bricolage systems.  [Sam]

=item *

Added F<bricolage.conf> directive to enable/disable the browser toolbar for
debugging and development. Documented in L<Bric::Hacker|Bric::Hacker>.
[Michael Robinton]

=item *

Added support for running Bricolage with SSL support on arbitrary ports.
Previous versions required https support to use only port 80 for http and port
443 for https. With this release, Bricolage fully supports http and https
service on any ports. This allows the Apache daemon supporting Bricolage to be
run with a minimum number of children while still allowing normal http and
https service on the standard ports with a light-weight Apache daemon. See the
F<INSTALL> file (or L<Bric::Admin|Bric::Admin>) for full details and an
example installation procedure. [Michael Robinton]

=item *

Added new F<bric_apachectl> command "single". This command will start
Bricolage in single-process mode. This mode is principally useful for
debugging. [Michael Robinton]

=item *

The size of the database column that stores custom field options (such as for
select lists) has been changed to the TEXT PostgreSQL type, so that the number
of options isn't arbitrarily limited. [Matt Vella]

=item *

The group API has been approximately 75% rewritten. The goal was to optimize
its performance, since group activity proved to be a serious bottleneck to
Bricolage performance. Those interested in the nitty-gritty details of the
rewrite can read about them here:
L<http://sourceforge.net/mailarchive/forum.php?thread_id=967943&forum_id=561>.

=back

=head2 Bug Fixes

=over

=item *

Added constraint to the group table to keep a group from having itself as a
parent. Thanks to JoE<atilde>o Pedro GonE<ccedil>alves for the patch. [David]

=item *

Fixed bug in side navigation where an HTML table was opened but not closed.
[Charles Albrecht]

=item *

Fixed bug where installation system would chown all of the chosen TEMP_DIR to
SYS_USER. Thanks to Dave Rolsky for the report. [Sam]

=item *

Fixed a bug in the installation system that was creating empty comp/comp and
data/data directories BRICOLAGE_ROOT. Thanks to Michael for the spot. [Sam]

=item *

Fixed remote previews to redirect to a better URL. [Mark]

=item *

Fixed a bug where trying to create a story through the SOAP interface
containing a contributor with an empty middle name would fail.  [Sam]

=item *

Changed strftime instances of '%G' to '%Y' in URI preference, as this seems to
be more portable. [David]

=item *

Fixed bug that was preventing 'make upgrade' from running database upgrade
scripts. [Sam]

=item *

Fixed broken "Log" link on Media Search results screen. [Sam]

=item *

Fixed bug where deleted output channels were showing up in list of available
output channels in the element profile. [David]

=item *

Fixed conflict in list manager that prevented some lists from working
properly. Probably never showed up before, as we only noticed it with the new
Media Type manager. Thanks to Scott for the heads-up. [David]

=item *

The C<PREVIEW_MASON> configuration directive no longer is no longer defaulting
to on in one context and off in another. It is now off by default. Thanks to
Michael Slattery for the spot! [David]

=item *

Eliminated the password field type from the formBuilder interface used for
contributor types and elements. Its inclusion up to now may be considered a
bug. [David]

=item *

Fixed cover date editing to repopulate correctly on the Story profile screens.
[Matt]

=item *

Fixed bug where previewing a story assigned to multiple categories would
preview to a random category. Now the primary category is always chosen. [Sam]

=item *

Fixed display and editing of dates more than one year in the past. [Matt]

=item *

Fixed bug where setting CHAR_SET to UTF-8 in bricolage.conf would result in
blank output. [Sam]

=item *

Changed Category manager to display no categories by default, only display
them after a search. This is because some folks have a I<lot> of categories.
[David]

=item *

Fixed bug where when C<SYS_USER> and/or C<SYS_GROUP> wasn't in
F<bricolage.conf>, Bric::Config would use the username "nobody" instead of the
UID for the user "nobody". [David]

=item *

Adding a note to a story that has not yet been saved no longer causes an
error. [David]

=item *

Fixed "make dist" to work on Mac OS/X and FreeBSD. [Sam]

=item *

Fixed a problem in Bric::Util::Burner::Template where a newly added
template wouldn't be picked up by <tmpl_include>.  This was due to
caching being turned on.  HTML::Template's cache doesn't know that a
new compilation would turn up a difference <tmpl_include> so it
continues to use the old one.  [Sam]

=item *

Fixed installer to not require unneeded Apache modules (mod_proxy and
mod_rewrite). [Sam]

=item *

Fixed installer to first ask whether SSL support is desired before asking for a
specific SSL module. [Sam]

=item *

Fixed documentation bug in Bric::Admin concerning PostgreSQL paths. Thanks to
Vicki Brown for the catch. [Sam]

=item *

Fixed installation system to fail if there are errors importing the database.
Also added test for missing or empty bricolage.sql. [Sam]

=item *

Fixed installation system to support optional modules and not force users to
install them. [Sam]

=item *

Fixed bug that prevented the contents of fields to be updated through
Bric::SOAP. [Sam]

=item *

Fixed "Checkin and Publish" button to only appear if the user has permissions
to publish. [Matt]

=item *

Fixed bug where text pasted into Bulk Edit textarea box was getting words
smooshed together. Thanks to Rachel Murray for the spot. [David]

=item *

Fixed bug where date field elements weren't getting properly converted between
the local time zone and UTC, which is the time zone of all the dates in the
database. Thanks to Matt Vella for the spot. [David]

=item *

Fixed issue where Bric::Util::Grp was adding every member of a group whenever
a new member was added. This was very wasteful, and slowed performance a great
deal for groups with thousands of members. Thanks to Mark for the spot.
[David]

=item *

Added check for Category "Directory" string to make sure that no non-URL
characters are added. [Matt Vella]

=item *

Clicking "Cancel" when editing keywords in a new story now properly returns to
the story profile, rather than to the last screen before the story was
created. [David]

=item *

Deleting a a contributor immediately after adding one no longer causes all of
the contributors to be deleted on check-in. [David]

=item *

Contributors are now properly reverted when stories and media are
reverted. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.3.2 (2002-06-09)

=head2 New Features

=over

=item *

Added --chunks option to bric_republish to publish stories in batches.
This is useful to avoid timing out on long runs. [Sam]

=item *

Added [Check In / Publish] button to Story Profile to checkin and
publish in one step. [Matt]

=item *

Added needs_publish() method and associated published_version database
field to Bric::Biz::Asset.  This method is now used by the publisher
to determine if something needs republishing.  Added new graphics to
display this information on the desks.  [Matt]

=item *

Moved repeated publish and preview functionality into
Bric::Util::Burner.  Updated Mason code and Bric::SOAP::Workflow
accordingly.  [Matt]

=item *

Added C<DBI_PROFILE> bricolage.conf option and C<bric_dbprof> script
to allow profiling of Bricolage database performance.  [Sam]

=item *

Added C<bric_apachectl debug> command to run Bricolage under the Perl
debugger using Apache::DB.  [Sam]

=item *

Added checks to make sure Story and Media URIs are unique within the
system.  [Matt]

=item *

Added search paging preference to break search results into multiple
pages.  [Adam]

=item *

Added support for running Bricolage under Devel::Profiler with the new
PROFILE configuration option.  [Sam]

=item *

Added support for Apache::SizeLimit to keep Apache process size under
control.  [Adam]

=item *

Revised Bric::App::Cache to improve performance.  The new system is a
two-level cache with Cache:Mmap and Cache::Cache.  This results in a
2x speedup on some cache-sensitive operations.  [Sam]

=back

=head2 Bug Fixes

=over

=item *

Clicking "Add More" when editing contributor contacts now retains any changes
made to the contributor profile. This matches the functionality of the user
profile. Thanks to JoE<atilde>o Pedro GonE<ccedil>alves for the spot. [David]

=item *

Fixed bug in Bric::SOAP::Element where deleting an element or field
could cause SQL errors due to overflowing the name field. [Sam]

=item *

Removed Bric::SOAP::Element->delete(force => 1) which could cause data
corruption in existing stories.  Also removed dependent options in
bric_dev_sync (--delete-existing) and bric_soap (--force). [Sam]

=item *

Fixed bug in Bric::SOAP::Element where updating an element could cause
Stories using that element to lose track of their field data. [Sam]

=item *

Fixed bug in Bric::Util::Burner::Template where <tmpl_include>s caused
syntax errors. [Sam]

=item *

The Bric::Biz::Category class method get_attr() now returns attributes for
category ID 0 as well as all other categories. [JoE<atilde>o Pedro
GonE<ccedil>alves]

=item *

Fixed bug in DBI_DEBUG and DBI_CALL_TRACE options where non-prepared queries
(row_aref(), all_aref(), etc.) were not being logged. [Sam]

=item *

Fixed bug in Bric::Dist::Resource that was causing publish to run very
slowly by executing a bad database query. [Sam]

=item *

Related to the last item, fixed a bug in Bric::Util::Coll that would call
the href() method on a class and pass in undefined values as parameters.
This will happen if a collection is created for a new object that does not
yet have an ID. The fix thus prevents the "= NULL" SQL syntax, which always
matches nothing. The new syntax for constructing a collection has been
implemented across the API. [David]

=item *

Fixed bug where the root category wasn't able to be added to a category
group. Actually, this fixes a problem where any object with an id of 0
couldn't be added to a group. Thanks to Mark for the spot. [David]

=item *

Changed mover list to be sorted in alphabetical order in the Destination
profile. This has the benefit of forcing "FTP" to be listed before "File
System" -- Hurray for case-sensitive ordering! Thanks to Sam for the
complaint. [David]

=item *

The OS for a destination server now defaults to the OS of the server on
which Bricolage is installed instead of "Mac". Thanks to Sam for the spot.
[David]

=item *

Deleted destinations will now be dissociated from output channels when
they're deleted. This prevents stories from being published to deleted
destinations. Thanks to Mark for the heads-up. [David]

=item *

Fixed bug where attribute metadata wasn't getting deleted when it was
supposed to. [JoE<atilde>o Pedro GonE<ccedil>alves]

=item *

Fixed bug where some browsers submit an image button with a value stored in
the image button's name as well as in the name with ".x" and ".y" appended
to it. This caused callbacks to be triggered twice for a single field! I
noticed this with Mozilla on Mac OS X, and presume it would happen
elsewhere, too. [David]

=item *

Fixed bug in navigation bar HTML that caused the bar to disappear on
certain browsers. [Rachel Murray]

=item *

Fixed bug in Bric::SOAP where Bricolage exceptions resulted in an
uninformative "Application error" message. Now the full exception message is
displayed. [Sam]

=item *

Fixed installation to work under Debian Linux 3.0 (testing). Thanks to Mark
Jaroski for a helpful patch. [Sam]

=item *

Changed length of Bric::Dist::Job name attribute from 64 characters to 256.
This allows long asset names to be used. Also added code to Bric::Dist::Job
to ensure that the name property is truncated if it's longer than 256
characters. Thanks to Josh Cox for the spot. [David]

=item *

Fixed bug where dumber browsers would submit a new template without any
Element selected. Thanks to Michael Robinton for reporting the bug. [David]

=item *

All stories and media are now required to be associated with a category. For
stories, the primary category cannot be deleted. If you want to change the
primary category, add a new category, change it to the primary, and then
delete the old primary category. This fix prevents previews and publishes
from breaking on stories and media that had no categories. Thanks to Mark for
the heads-up. [David]

=item *

An overhaul of the burn system had regressed the Output Channel preview
functionality. I've put it back now. [Mark]

=item *

Fixed button JavaScript to work correctly in Mozilla. [Matt]

=item *

Fixed bug in HTML::Template burner that prevented <tmpl_include>s from
working in some cases.  [Sam]

=item *

Numerous spelling errors were fixed by Scott Lanning. Thanks!

=item *

In the Element manager, doing a search after selecting an Element Type from
which to display elements no longer causes an error. Thanks to Adam Robinson
for the spot. [David]

=item *

Made the parent category field in the Category Profile a required field.
[Mark]

=item *

Fix Bric::Util::FTP::FileHandle to work with a modified date-formatting
preference. [Matt]

=item *

Fixed section numbering in the Contributor Type profile. [Scott Lanning]

=back

=cut

##############################################################################

=head1 VERSION 1.3.1 (2002-04-03)

=head2 New Features

=over

=item *

Bricolage SOAP interface fully implemented.  The command-line clients
bric_soap, bric_dev_sync and bric_republish are all complete. [Sam]

=item *

Bricolage now comes with a configure script and a Makefile for easier
installation and configuration. [Mark Jaroski]

=item *

Removed MD5 Perl module requirement by requiring Apache::Session 1.54 or higher.
[David]

=item *

Added new FTP distribution move method. Now you can distribute files either via
a file system copy or via FTP. [David]

=item *

Added a preference to change the way URIs are formatted. [Adam]

=item *

Added a URI case preference to force URIs to lowercase, uppercase, or
allow mixed case URIs.  [Adam]

=item *

Categories are now all listed and sorted by URI in select lists. [Sam]

=item *

The cache is now cleared when the Apache server is started or
restarted.  This avoids potential problems with stale data in the
cache. [Sam]

=back

=head2 Bug Fixes

=over

=item *

Fixed numerous cases where user_ids were being used as booleans.
Since user_id 0 is the Administrator's user_id this can cause problems. [Sam]

=item *

Fixed problem where deleting an asset would fail with the "cannot
check-in non checked-out version" error. [Sam]

=item *

Fixed bug in HTML::Template burner when an element name had more than
one space in it. [Sam]

=item *

Fixed bug in database that prevented element names over 32 characters
from working properly. [Sam]

=item *

Fixed bug where trying to preview a story without a Preview
destination and PREVIEW_LOCAL off would result in a Mason error. [Sam]

=item *

Fixed bug in Bric::SOAP::Story->create() where data element order was
getting lost. Thanks to Mike Slattery for the spot. [Sam]

=item *

Fixed bug in HTML::Template burner where templates in non-root categories
could not be found. Thanks to Marlon Bermas for the spot. [Sam]

=item *

Fixed Bric::Util::FTP::FileHandle to create new revisions on PUT. [Sam]

=item *

Deleting a contributor will no longer break stories with which the contributor
is associated. Thanks to Rachel Murray for the spot. [David]

=item *

Invalid configuration directives in bricolage.conf will now be caught and keep
Bricolage from starting. [Sam]

=item *

The view button in the element profile now works correctly. Thanks to
JoE<atilde>o Pedro GonE<ccedil>alves for the spot. [David]

=item *

Changed all strftime instances of '%G' to '%Y', as this seems to be
more portable. [David]

=item *

Checking in a template from a template profile now performs a syntax check of
the template just as saving the template does. [JoE<atilde>o Pedro
GonE<ccedil>alves]

=item *

Notes attached to stories and media are now once again editable from
the desk and profile views if they're checked out to the current user,
and only viewable otherwise. Thanks to Tracey Largay for the
spot. [David]

=item *

Fixed a few poorly-named time zones in the time zone preference. More
still needs to be done here, actually. [David]

=item *

Implemented the chk_syntax() method in Bric::Util::Burner::Template.
[Sam]

=back

=cut

##############################################################################

=head1 VERSION 1.3.0 (2002-02-10)

=head2 New Features

=over

=item *

Bricolage SOAP interface partially implemented. Bric::SOAP::Story and
Bric::SOAP::Media are fully implemented and tested. The command-line client -
bric_soap - is complete. [Sam]

=back

=head2 Bug Fixes

=over

=item *

Fixed numerous cases where user_ids were being used as booleans. Since user_id
0 is the Administrator's user_id this can cause problems. [Sam]

=item *

Fixed problem where deleting an asset would fail with the "cannot check-in non
checked-out version" error. [Sam]

=item *

Fixed bug in HTML::Template burner when an element name had more than one
space in it. [Sam]

=item *

Fixed bug in database that prevented element names over 32 characters from
working properly. [Sam]

=item *

All fixes in the soon-to-be-released 1.2.1 version. See below for details.

=back

=cut

##############################################################################

=head1 VERSION 1.2.3 (2002-03-17)

Functionally equivalent to 1.2.2, but includes required files missing from the
1.2.2 distribution.

=cut

##############################################################################

=head1 VERSION 1.2.2 (2002-03-15)

=head2 New Features

=over

=item *

Added chk_syntax() methods to Bric::Util::Burner and its subclasses. This method
will takes a template asset object and make sure that it compiles.
Bric::Util::Burner::chk_syntax() delegates to the proper subclass.

=back

=head2 Bug Fixes

=over

=item *

Some misspellings were corrected in Bric::Admin. Thanks to Ask Bjoern Hansen for
the spot. [David]

=item *

Fixed broken "Return" buttons on related media and related story pages. [David]

=item *

Fixed bug where assets weren't activated when they were created and then checked
in without clicking the "Save" button. [David]

=item *

Fixed bug where a fixed story's slug was getting used in its URI. [David]

=item *

Fixed broken image autopopulation fields (compression, height, width, etc.)
[David]

=item *

Fixed broken support for audio and video files. These can be set up by the Media
Type menu in Element Types. Eventually these should arrange for some fields to
be auto-populated (e.g., bit rate, frame size, length, encoding, etc.). [David]

=item *

Fixed bug where Categories with the same directory name could not be created.
Thanks to Andrew Baio for the spot. [David]

=item *

Fixed a bug where a user couldn't look at her own event log if she didn't have
permission. Thank to Michael Alan Dorman for the spot. [David]

=item *

Fixed a bug where permissions set to access workflows and desks had no affect on
the display of workflows and desks. Thanks to Rachel Murray for the spot.
[David]

=item *

Fixed bug where attempting to create a destination with the same name as an
existing but deactivated destination triggered an SQL error. Thanks to Michael
Alan Dorman for the spot. [David]

=item *

Fixed bug where Workflows with spaces in their names would not create proper
submenus in the left navigation bar. Thanks to the WHO for the spot [David]

=item *

Fixed bug where the wrong story might be previewed when clicking the title of a
story in My Workspace or on a desk. [David]

=item *

Changing the category a media asset is in now correctly updates the underlying
category object and the URI without the media asset needing to be checked in.
[Matt Vella]

=item *

Eliminated "Template compile failed" errors for templates with <%init> sections.
[David]

=item *

Field elements now show up with their display names in the bulk edit select
lists, instead of with their names (which are really keys). [David]

=item *

Eliminated "Use of uninitialized value in bitwise or (|)" warnings when checking
permissions. Thanks to Sam Tregar for the spot. [David]

=item *

Custom fields in elements and contributor types now remember their "size"
setting. Thanks to Sam Tregar for the spot. [David]

=item *

The Element select list on the new Template profile no longer lists media
elements, since media assets don't use templates. [David]

=item *

Removed old XML::Writer stuff from Bric::Util::Burner, since I moved it to
Bric::Util::Burner::Mason a while ago and it was causing some problems. Thanks
to Michael Robinton for the spot. [David]

=item *

Fixed typo in Bric::Hacker spotted by Axel Beckert. [Sam]

=item *

The CREATE permission works properly now. Thanks to Rachel Murray for the spot.
[David]

=back

=cut

##############################################################################

=head1 VERSION 1.2.1 (2002-02-25)

=head2 New Features

=over

=item *

Created new method of configuring Bricolage in Apache. For mod_perl 1.26 and
earlier, a custom config file will be written to the bricolage temp directory
every time Bricolage is started or restarted. For mod_perl 1.27 and later, no
temp file will be written. [David]

=item *

Added support for Mozilla (and there was much rejoicing!). [David]

=item *

Changed password for the default "admin" user to "change me now!" [David]

=item *

The slug is stored in the database for both fixed and non-fixed stories. This is
in anticipation of adding the ability to use the slug for fixed story URIs later
on. Thanks to Darren Graves for the patch.

=item *

Added DISABLE_NAV_LAYER directive. It's off by default, but if you turn it on in
bricolage.conf, the side navigation layer will be rendered as plain HTML in
every page instead of as a separate layer. [David]

=item *

Documented PERL_LOADER directive in Bric::AdvTemplates. [David]

=back

=head2 Bug Fixes

=over

=item *

Turned off the PREVIEW_MASON configuration directive in bricolage.conf. It should
be off by default. [David]

=item *

Deleted Output Channels now properly don't show up in the Output Channel manager
again. Thanks to Sara for the spot! [David]

=item *

All previews now preview assets in the primary Output Channel only. Previously,
the previews were in the Output Channel whose name came first alphabetically.
Thanks to Sara Wood for catching this bug. [David]

=item *

Fixed bug where templates often couldn't be found by the Mason burner if the
output channel had a post_path. [David]

=item *

Fixed bug where templates often couldn't be found by the HTML::Template burner
if the output channel had a post_path. [Sam]

=item *

Fixed some problems with the sideNav menus under Netscape. [David]

=item *

Fixed broken "Preview" button in Read-only story profile and in related story
elements. [Matt Vella]

=item *

Updated debugging code to accommodate new syntax in Cache::Cache. Thanks to Sam
Tregar for the spot. [David]

=item *

Fixed problem with Element names containing non-alphanumeric characters. [Sam]

=item *

Checking out media assets from "Find Media" now redirects you to the media
profile if you've checked out one media asset, or My Workspace if you've checked
out more than one. This puts it in line with how "Find Stories" and "Find
Templates" work. Thanks to Sam for the report. [David]

=item *

Fixed bulk edit functionality for Media assets. Thanks to Sam for the spot.
[David]

=item *

In Bric::Biz::Asset::Business, the source get_meth key in my_meths() now works
properly. Also, get_all_keywords() now also returns the category keywords as
well as the story keywords. Thanks to Darren Graves for the patch.

=item *

Removed quotation marks from DEF_MEDIA_TYPE setting in F<bricolage.conf>.
Thanks to Darren Graves for the spot. [David]

=item *

Sorting assets by ID in "Find X" and Workspace/Desk view now properly does a
numeric sort rather than an alphanumeric sort. Thanks to Sam Tregar for the
spot. [David]

=item *

Fixed an obscure bug where, for files uploaded as part of a Media file,
Bricolage attempted to create a path on its own file system using path
delimiters for another file system. Thanks to Mike Slattery for the spot.
[David]

=item *

Required content fields in stories and elements are now displayed in the order
specified in the Element profile. Thanks to Sam Tregar for the spot. [David]

=item *

All assets now start with the version number 0 until the first time they are
checked in. Also, they will show up on desks and in the Find views after the
first time they are saved. It was inconsistent before, and some items could not
be seen in the desk and Find views until they were checked in. Thanks to Sam for
spotting the inconsistency. [David]

=item *

The bric_clean_tmp script has been changed to avoid deleting the Bricolage
cache file.  [Sam]

=item *

Fixed typo that broke Bric::Dist::Client. [Mike Slattery]

=item *

Fixed multiple select custom fields for Elements and Contributors. Thanks to
Mike Slattery for the spot. [David]

=item *

Fixed ugly bug where deleting a "Media Type" Element would delete all the media
objects of that type. Thanks to Sam for the spot (though not for the bug!).
[David]

=item *

Fixed bric_pgimport so that it uses DBI to drop and create the database, rather
than relying on a hard-coded location for pgsql binaries. [David]

=item *

Fixed permission granting in bric_pgimport so that the Bricolage database use
has DELETE permissions on all objects in the Bricolage database. It looks like
this permission was ignored in PostgreSQL 7.1 and earlier, or problems would have
shown up a long time ago! [David]

=item *

Fixed a bug where the time a distribution job is scheduled was not properly
converted to UTC for storage in the database. Thanks to Mike Slattery for the
great code archaeology! [David]

=item *

Fixed the spelling of "contributor" in several spots. [Andrew Baio]

=item *

Fixed bug where changing a story's primary category left it with B<no> primary
category. [Matt Vella]

=back

=cut

##############################################################################

=head1 VERSION 1.2.0 (2002-01-10)

=head2 New Features

=over

=item *

Added Context-sensitive, online help. [Sam]

=item *

Added separate interface for editing templates (via FTP). [Sam]

=item *

Added the ability to use HTML::Template Templates. [Sam]

=item *

Added ability for different Output Channels to function as different component
roots for in Mason templates. This will allow for templates that can't be found
in the current Output Channel to be searched for in other Output Channels.
[David]

=item *

Added link to Event log to Find Story, Find Template, and Find Media screens.
[David]

=item *

Added true previewing for media assets. Now, when you click their URIs to
preview them, they will be distributed to the preview server(s) before
redirecting the user to them, rather than just serving them up from where they
live on the Bricolage file system. The latter can still be accessed under
"Download" in the Media Asset profile. This will continue to be the preferred
way to grab media files for editing and such, as it will not incur the overhead
of distributing the media file. [David]

=item *

Allow only one template with a given name for a given category, element, burner
and output channel. [Sam]

=item *

Added a Maintainer section to the About page. [David]

=item *

Updated About page to mimic the layout of the help pages. [David]

=back

=head2 Bug Fixes

=over

=item *

Fixed a bug with local previews where a preview page could show up instead of
the Bricolage UI. Thanks to Sara for the spot. [David]

=item *

Fixed a bug where Mason component calls failed in previews when the
PREVIEW_MASON directive was enabled. [David]

=item *

Changed default value for text area fields added via the form builder (i.e., in
Contributor Type and Element profiles) to 0. The values 0 and "" always make the
the new field unlimited in length. [David]

=item *

Fixed a couple of buttons to be proper case rather than upper case. [David]

=item *

Separated the filesystem destinations for assets burned for publication and for
assets burned for previewing. This will prevent someone previewing and stomping
all over a published version of an asset before the published version is
distributed. [David]

=item *

Removed hard-coding of the local preview directory in httpd.conf and
httpd-ssl.conf. Now using the values stored in PREVIEW_LOCAL, instead, to
determine the proper directory. [David]

=item *

Added the DEF_MEDIA_TYPE directive. Bricolage will use the value in this
directive to assign a Media Type to all file resources if Bricolage can't
figure it out from their file extensions. This fixes a bug where Bricolage would
choke if it couldn't figure out the MediaType itself. [David]

=back

=cut

##############################################################################

=head1 VERSION 1.0.2 (2001-12-10)

=head2 New Features

=over

=item *

Added "File Name" and "File Extension" properties to OutputChannels. These
properties will now be used to name files burned to the file system on
preview and publish. [David]

=item *

Added DEFAULT_FILENAME and DEFAULT_FILE_EXT configuration directives to set
default values on the "File Name" and "File Extension" Output Channel
properties. [David]

=item *

Changed Bric::Util::Burner->display_element() so that it doesn't paginate. All
paginated pages are now treated instead as regular elements. This is useful for
things like printer-friendly pages. Bric::Util::Burner->display_element()
continues to work as before. Use this method to output a separate file for each
paginated element. [David]

=item *

When errors occur while previewing stories, the leftNav is now turned off.
[David]

=item *

Browser buttons and menus are now disabled. [David]

=item *

Added ability to set permissions on assets based on the categories they're in.
[David]

=item *

Moved all session and session locking files into the "bricolage" subdirectory of
the local file system's tmp directory. You'll want to rm -rf /tmp/bricolage_*
upon upgrading. [David]

=item *

Moved the location of cache files to the "bricolage/cache" subdirectory of the
local file system's tmp directory. You'll want to rm -rf /tmp/FileCache upon
upgrading. Together with the above change, this means that all Bricolage
temporary files are stored in the "bricolage" subdirectory of the local tmp,
e.g., /tmp/bricolage. [David]

=item *

Added new program, bric_clean_tmp, that can be used in a cron job to delete
stale temporary files. [Sam]

=item *

Added an "About" page, linked from the logo graphic, that explains the name
"Bricolage" and offers the license and credits. [David]

=item *

Added PERL_LOADER configuration directive. Pass a line of Perl to this
directive, and on startup, it'll execute it in the same namespace as your
templates execute in. [David]

=item *

Added INCLUDE_XML_WRITER and XML_WRITER_ARGS configuration parameters. If
INCLUDE_XML_WRITER is turned on, then all templates will include a new global,
$writer, that is an XML::Writer object. This object is provided as a convenience
for creating XML in your templates. XML_WRITER_ARGS allows certain arguments to
be passed to the XML::Writer. [David]

=item *

Fixed bug where data fields deleted from Elements were deleting them from
existing stories, too. [David]

=item *

Fixed bug where stories with related media associated with them were displaying
the story as an Element rather than as a story after editing the related media.
[David]

=item *

Removed all file system location dependencies for the operation of Bricolage.
Bricolage will still assume that everything's in /usr/local/bricolage, but any
location is fine as long as the BRICOLAGE_ROOT environment variable is set to
the proper location. [David]

=item *

Added code to force all preview pages to be re-requested from the server every
time they're viewed. This prevents the browser from loading older versions from
its cache, and allows users to always see the most recently-burned output of a
story. [David]

=item *

Removed debugging information from URLs for when debugging is turned off --
which should be always in production code (e.g., releases). [David]

=item *

Elements are now displayed with their display names rather than their attribute
names. Thanks to Sam Tregar for the spot. [David]

=item *

Fixed bug where fields (attributes) added to an Element with the name of an
existing but deactivated field triggered an error. Thanks to Sam for the
heads-up. [David]

=item *

Fixed a bug where data fields sometimes were not properly retrieved from the
database in Bric::Biz::AssetType. [David]

=item *

Fixed a bug where clicking "Save and Stay" in the Element profile wouldn't
delete attributes (fields) marked as such, or even delete the Element itself, if
the "Delete this profile" checkbox was checked.

=item *

Fixed a bug where, for Story and Media assets, editors were given Edit access to
notes, even when they didn't have the asset checked out. [David]

=item *

Changed the misleading and inaccurate "Two blank lines" label in the Bulk Edit
interface to the more accurate "One blank line". Thanks to Sam Tregar for the
heads-up.

=back

=cut

##############################################################################

=head1 VERSION 1.0.1 (2001-09-28)

=over

=item *

Initial public release.

=back

=cut

##############################################################################

=head1 AUTHOR

David Wheeler <david@justatheory.com>

=head1 SEE ALSO

L<Bric|Bric>

=cut
