Changes - CGI::Widget::DBI::Browse change logfile
all changes without author attribution are by Adi Fairbank
Ensure all ampersands are html-escaped in final html output: & -> &
Add new -category_before_link_closures option, for customizing content before each category nav <a/> link, inside the table <td/> cell
Code optimization to decrease memory footprint: get rid of $self object inside anonymous sub returned by _category_columndata_closure()
New public method grid_layout_enabled() so subclasses can tell if we are in grid or table display mode
New method configure_grid_or_table_view() to add support for switching between grid and table view when browse results are reached; also add -default_grid_layout option to change default view to grid
Support NULL or empty string values in browse categories, showing '(empty)' to the user
Fix a couple tests for indeterminant html attribute order, to prevent intermittent failures
Add support for overridden -display_columns in display_results() method
Add new method re_add_breadcrumbs_to_header()
Add id attributes and <span/>'s to breadcrumbNavLink <a/> elements, so the breadcrumbs can be renamed with CSS
Make code run with CGI 4 without warnings about calling param() in list context
call translate() method from Search module v0.31 on user-visible English strings, to support internationalization
add a span around "Show all items in this category" so it can be replaced (via CSS) with something else
add empty div so content can be added (via CSS content:) at the top of browse results for any level in category tree
more unicode fixes: decode utf8 chars in link_for_category_column() and when -cache_categories enabled
add utf8 escaping to support browsing datasets with non-english-language characters
add exception handling to prevent circular reference memory leak if an error occurs in display of results
update for refactoring in CGI::Widget::DBI::Search version 0.30
bugfix: auto-skip to results code was breaking the case of a single browse result on the final page of category choices
HTML escape the id of the <a/> tag of each category browse choice
minor performance improvement by eliminating unnecessary calls to HTML-generation methods
bugfix in unicode handling: use uri_escape_utf8() on all query string values in URIs used for navigation
change id attribute of category navigation href: was just "categoryNavLink", now "categoryNavLink-[CATEGORY]" where [CATEGORY] is the category value where the user would navigate to if the href is followed
minor change in behavior of -auto_skip_to_results: enable auto-skip for any category with just a single member, instead of only no members (sub-category value NULL) or single empty string member, since the whole point of this module is to make browsing datasets in a browser *easy*
add new -exclude_vars_from_breadcrumbs option to exclude some -href_extra_vars params from breadcrumb links
refactor add_breadcrumbs_to_header() to make individual breadcrumbs available to calling object
minor change to behavior of parent_category_column() and ancestor_category_columns() methods: when auto_skip_in_effect, return the parent or ancestors *before* auto-skip, instead of after
improve link_for_category_column() method to support list of params to exclude from generated href, even when preseent in -href_extra_vars (useful for removing a search string param)
add -href_extra_vars from search widget to query string for all browse navigation links: category browse, breadcrumb, skip-to-results, and link returned by link_for_category_column() method
minor API changes: - new method auto_skip_to_results() which runs just the auto-skip code; also sets 'auto_skip_in_effect' object variable when auto-skip is triggered - new method build_results() which performs the search and calls auto_skip_to_results(), in case external classes want to build results before calling display_results
document public methods, in preparation for first CPAN release
add link_for_category_column() method to generate a link back to a certain place in the browse tree based on current result row data
make auto-skip feature work with both no category rows, or a single category value of empty string: ''
add -post_auto_skip_callback to allow a callback routine to run to update state of widget if in auto-skip mode
add new -auto_skip_to_results option for auto showing results when we reach a category which has no members
reformat display of skipToResultsLink to show on same line as breadcrumbs
add support for a pre-existing search widget object in object construction
set -form_extra_vars for _browse_skip_to_results_ so browsing will work embedded in forms
fix for when used with -sql_search_columns / -sql_join_for_dataset options of CGI::Widget::DBI::Search, and new test case
new method category_title() which returns a context-specific title which can be displayed to the user to denote where in the browse tree they currently are
add hidden form fields to html output so category navigation state will be preserved across form (POST) submits
fix bug when a column in -sql_retrieve_columns has a table alias (e.g. i.sub_category)
add -category_sql_retrieve_columns and -category_column_closures options, for extra flexibility when rendering categories in browse mode (internal nodes in the browse tree)
reverse order of columns returned by ancestor_category_columns()- now returned in same order as listed in -category_columns
add automatic category caching functionality with -cache_categories option, for faster rendering of internal nodes in the browse tree
refactoring to split component functionality into concise methods, for better reuse. new methods: configure_search_for_category_browse(), add_breadcrumbs_to_header()
new methods parent_category_column(), and ancestor_category_columns() based on current position in browse tree
add is_browsing() method to API to determine whether widget is browsing or showing results
initial release
To install CGI::Widget::DBI::Browse, copy and paste the appropriate command in to your terminal.
cpanm
cpanm CGI::Widget::DBI::Browse
CPAN shell
perl -MCPAN -e shell install CGI::Widget::DBI::Browse
For more information on module installation, please visit the detailed CPAN module installation guide.