2004-06-07 Darren Duncan <perl@DarrenDuncan.net> * Release 0.51. * This is primarily a bug fix and/or compatability release. * Renamed all demo/example modules besides the core 5 so that their names all start with 'Demo'. These demo/example modules all had/have top-level names, and after the change there should not be any name conflicts with other CPAN modules that should have the original top-level names. All references to these module names in other files were also updated. * Moved the 5 'main' demo modules (which I actually use in production) into the 'lib' folder: "Demo[GuestBook|MailForm|Redirect|TextFile|Usage]". Now they are also test-compiled by CGI-Portable.t. * Several documentation fixes or changes in CGI::Portable (now v0.51). * Fixed a couple "\1 better written as $1" warnings in the search_and_replace_url_path_tokens() method of CGI::Portable. * Removed unused "@ISA" global var declaration from DemoUsage (now v0.51). * Since no one should be actually using the renamed demo modules, this release is completely backwards compatible. 2004-06-06 Darren Duncan <perl@DarrenDuncan.net> * Release 0.50. * Updated this distribution's external dependencies on CGI::MultiValuedHash to v1.09. That module's API didn't change, but it had a bug fix. * The 4 modules that CGI::Portable subclassed (::Errors, ::Files, ::Request, ::Response) in release 0.472 are now merged into it as of release 0.50. The result of this 5-way merge has a version of 0.50, and can be used identically to the old module. No new code or features were added. The new module has all of the old 5's documentation, slightly altered as was necessary for the merger. Due to the elimination of redundancies, the new module is 17% smaller than the combined size of the old 5. Every other module in this distribution was also updated to version 0.50, even though they otherwise had no changes (1 exception). * Small feature update in CGI::Portable::AppMultiScreen whereby set_multi_screen_no_delegate_message() now spits out an 'http_status_code' of '404 Not Found' to go with the "screen doesn't exist" error page that it generates. It used to leave the default status code of '200 OK' to be returned, which is technically wrong even though the user sees the same thing. As a result of the change, web crawling robots such as search engines should record that an external link pointing to your "doesn't exist" page is broken, and they shouldn't index "doesn't exist" as if it were a valid page, sending more visitors straight to it later. This shouldn't break anything unless you depended on the old, broken behaviour. * Note that if you referenced any of the 4 modules that don't exist by name, then just substitute 'CGI::Portable' for the old name and your code should continue to work as before. * Besides the aforementioned, this release is completely backwards compatible with the previous one, so you should be able to swap it in without problems. * Renamed t/CGI-Portable-Framework.t to t/CGI-Portable.t. 2003-03-21 Darren Duncan <perl@DarrenDuncan.net> * Release 0.472. * The only change in this release was to fix t/CGI-Portable-Framework.t, where I had forgotten to declare (and set) a variable before using it. This omission had caused "make test" to completely fail. 2003-03-16 Darren Duncan <perl@DarrenDuncan.net> * Release 0.471. * This is a small maintenance release that is mainly for improving documentation. Similar maintenance releases are being done with all of my distributions simultaneously. A lot of it was formatting issues that were easy to miss before; the other bullet points below list the non-formatting issues. These files had formatting fixes: Portable.pm, Request.pm, Response.pm, AdapterCGI.pm, AppMultiScreen.pm, ChangeLog, ReadMe. * The distribution file layouts have also been standardized. Modules were already in a "lib" folder so no change was needed there. Tests were put in a "t" folder. "test.pl" was changed to "t/CGI-Portable-Framework.t". * Updated all Copyright statements to a better (and longer) version, which is dated 1999-2003. Your rights to use these modules haven't changed, but they may now be easier to understand. These statements appear once in the ReadMe file at the bottom (under "AUTHOR"), and twice in each module (.pm file), a full version at the bottom (under "AUTHOR") and a shorter version at the top (in code comments). * Added the "use warnings" pragma at the top of all files beside "use strict"; every occurance of "use strict" gained a "use warnings" whether it was in the module proper or in its test script or in its SYNOPSIS. This should save users from having to put -w on the command line for them. * Incremented all module $VERSION numbers by 0.001, and all test scripts to require the new versions. Also, where any of my modules use others of my modules, they now require the latest version as of this writing, for simplicity of maintenance. * Updated all test scripts to read $verbose from @ARGV (command line arguments), and other test script improvements. * Updated these sections of the ReadMe file: REQUIREMENTS, INSTALLATION. 2001-11-04 Darren Duncan <perl@DarrenDuncan.net> * Release 0.47. * Updated CGI::Portable::Request so that it now stores all raw http request details, rather than just some of them. To implement this, two properties named "request head" and "request body" were added; the first is a hash and the second is a scalar. Their format and accessor methods are designed to mirror those for the "http head" and "http body" in Response. Therefore, 5 new accessor methods were added: get_request_headers_ref(), [get/set/add]_request_headers(), request_body(). The older methods referer() and user_agent() have been re-implemented to retrieve and set certain key/value pairs in "request head" rather than have their own properties, which were deleted. Many property accessor groups, other functions, and their POD were rearranged into a more logical order, starting with raw connection and request details, then parsed user input, then functions for making new call-back urls. Despite this, no existing code was changed, so all the existing functions work the same as before. This Request version 0.47 should be backwards-compatible with version 0.46. Much of the overview POD was rewritten to be easier to understand, so you should have a better idea what the features represent. Note that all "user path/query/post/cookies" properties are parsed copies of various "request" properties, which are the raw versions; both can be stored to give you maximum flexability. * The two demo modules named DemoStatic and DemoSegTextDoc have been merged into a single module named DemoTextFile, at version 0.47. Any of your scripts that used DemoStatic can use DemoTextFile with no changes besides the name of the module called. Scripts that use DemoSegTextDoc will need to, in addition to the rename, pass an extra preference of "is_text => 1" in order to replicate the old behaviour. The new module is more flexible than its predecessors by letting you have multi-part documents that are either plain text or html (not plain text only). In addition, extra title and creator and date information is only displayed if the preference "title" has a value, so you can have multi-part documents without extra headers now. Any demos have been updated where necessary to the new module name. * No other files were changed, and are still at version 0.46. 2001-09-30 Darren Duncan <perl@DarrenDuncan.net> * Release 0.46. * IMPORTANT: Rewrote the take_context_output() methods in all CGI::Portable::* modules that had them: Errors, Files, Request, Response, suffixless. Be aware that the changed methods have a different default behaviour than before, as well as that they take a different argument set. You should check any of your code which calls this method, because it may very well break if it used any arguments or depended on specific behaviour. Specifically, the new arguments [CONTEXT, LEAVE_SCALARS, REPLACE_LISTS] replace the old arguments [CONTEXT, APPEND_LISTS, SKIP_SCALARS]. The new default behaviours regarding when CONTEXT properties overwrite SELF properties have been changed so that they more closely match what one would intuitively expect to happen. No longer will null properties overwrite properties with values. Also, lists are now combined by default rather than replaced, which works well when you have multiple "application components" subcontracted to make different regions of the same screens; previously, the last component would overwrite earlier ones by default. Scalar properties in "taken" CONTEXTs still will overwrite ones in SELF by default, but this time only if they aren't null. See the method's own POD for more. * Added method page_search_and_replace() to CGI::Portable::Response, which replaces the search_and_replace_page_body() method in CGI::Portable; the latter was deleted. Correspondingly, the deprecated preference named "page_replace" that was handled by CGI::Portable::AppStatic has been renamed to "page_search_and_replace". The renamed preference works the same as before, and should be permanent. Also, added property and method page_prologue() to Response and a corresponding "low/high_page_prologue" properties to AppStatic. The new method and properties have no effect unless your HTML::EasyTags install is 1-06 or later. * Added module CGI::Portable::AppMultiScreen, an "application component" that lets you easily define a group of screens that are related, delegate the construction of each screen to separate "components", and simplify the creation of links between the screens. The module is subclassed from AppStatic. This module has complete POD so you can get a good description by reading that documentation. This module is meant as a non-proprietary replacement for DemoMultiPage; the latter module was deleted. The preferences handled by DemoMultiPage were renamed as follows: "vrp_handlers" to "delegate_list", "def_handler" to "default_delegate", "wpm_module" to "module_name", "wpm_prefs" to "preferences", "wpm_subdir" to "file_subdir". The new module does not have any replacement for the older "menu_items" and related preferences for generating html menus of hyperlinks between the various screens, and it will not get any due to the proprietary nature of such a task. If you used "menu_items" before then you will need to make the hyperlinks yourself and attach them to the pages. It really isn't that difficult; see the "website" demo for an example of how to do it now. * Added module CGI::Portable::AppSplitScreen, an "application component" that lets you easily divide a response screen into multiple regions and then delegate the construction of each region to separate "components". You define the regions within the standard "preferences", and no other input is required. The module is subclassed from AppStatic. This module has complete POD so you can get a good description by reading that documentation. Before this module became available, you would have had to do your own programming for such simple tasks as adding page headers or footers that are stored in a different file of their own; now such activities can be done with nothing more than ordinary config files. * Updated CGI::Portable::AdapterCGI so that it will always read posted data up to Content-length bytes. While it never got more than that before, it had also refused to read content if there was more than 100K of it. This change brings more behaviour partity with AdapterSocket. * Small update to the search_and_replace_url_path_tokens() method of CGI::Portable so that it didn't leave a trailing "?" on urls when there was no query string. * Various small updates were made to the demo modules to keep them up to date with the main module changes, above, so they don't break. * Various small updates were made so that the output of the modules is better compliant with XHTML. All HTML now has lowercased tags, among other things. However, it should continue to work with older web browsers. 2001-08-26 Darren Duncan <perl@DarrenDuncan.net> * Release 0.45. * In summary, this release adds a new module, CGI::Portable::AppStatic, removes a now-redundant existing one, CGI::WPM::Base, adds some methods to other modules (mostly Response), deletes a few methods (mostly Request), renames a number of methods (about 10% of Request), and renames the main demo modules (all CGI::WPM::* became Demo*). These changes were done to further streamline the modules, and prepare for large feature additions in subsequent releases. Some of your code may break due to the changes, but a simple search-and-replace should be all that's necessary to fix it. * All files had versions changed to 0.45 whether changes were made or not. * Updated CGI::Portable::Request to delete the following 3 methods along with their associated properties: url_path_is_in_path_info(), url_path_is_in_query(), url_path_query_param_name(). There were related simplifications made to the module set such that it is expected that the "user path" or "url path" are always stored as the "path info"; the option to store it as a "query string" argument instead has been removed. You should not need to change your code to reflect the above change, as the public interface of the url-making methods were not changed. However, you probably want to reset your app if you used the query string store because any web screens currently served would then have invalid hyperlinks in them. * Renamed several methods that store request details: virtual_host() became server_domain(), remote_addr() became client_ip(), remote_host() became client_domain(). These methods were added: server_ip(), client_port(). To round out the six-method set, server_port() was kept unchanged from before. Also, the methods request_uri() and request_protocol() were added to complement request_method(), which remained as before; the script_name() method was removed since it became partially redundant with request_path(). Accordingly, CGI::Portable::Request, CGI::Portable::AdapterSocket, CGI::Portable::AdapterCGI, and all "CGI::WPM::*" modules were updated. * Updated CGI::Portable::Response by adding these methods: set_http_cookies(), add_http_headers(), add_page_meta(), add_page_style_sources(), add_page_style_code(), add_page_frameset_attributes(), add_page_body_attributes(). The delete_http_cookies() method was deleted, but its effect can be simulated by calling set_http_cookies() with an empty array ref argument. * Added module CGI::Portable::AppStatic, an "application component" that lets you define whole response screens within a config file. This module is meant as a non-proprietary replacement for CGI::WPM::Base; the latter module was deleted. The preferences handled by CGI::WPM::Base were renamed as follows: "http_target" to "low_http_window_target", "page_body" to "high_page_body", "page_header" to "prepend_page_body", "page_footer" to "append_page_body", "page_title" to "low_page_title", "page_author" to "low_page_author", "page_meta" to "add_page_meta", "page_css_src" to "add_page_style_sources", "page_css_code" to "add_page_style_code", "page_body_attr" to "add_page_body_attributes". Any modules that used CGI::WPM::Base have been updated to use CGI::Portable::AppStatic instead; the exception is CGI::WPM::Usage, which now uses neither of them. The new module does not yet have an elegant replacement for the older "page_replace" property, so it continues to support that property as a deprecated feature. * Renamed all "CGI::WPM::*" modules to "Demo*" since they truly belong with the demos. If you use any of these then you will need to search-and-replace any calls to the module name. They otherwise work the same way as before. * Removed support of the "amend_msg" preference from all "Demo*" modules. This preference had allowed one to customize the text for a portion of most error screens, so that portion is no longer customizable. * Removed support of the "url" preference in the DemoRedirect module. This preference had allowed DemoRedirect to always use the same target url, rather than getting it from the query string parameter named "url". Now, the query string is the only place that DemoRedirect looks. However, you can now use CGI::Portable::AppStatic directly (and not use DemoRedirect) to replace the lost functionality. Then, you set the high_http_status_code preference to "301 Moved" and "high_http_redirect_url" to the destination. * Updated CGI::Portable and many of the demo modules to make them more XHTML-compliant. Specifically, all main screen headers are now '<H1></H1>' rather than '<H2 ALIGN="center"></H2>'. Users who want their headings to appear a specific way, like centered, should use a stylesheet to say so. 2001-06-11 Darren Duncan <perl@DarrenDuncan.net> * Release 0.44. * This release does not update any of the core modules having "CGI::Portable" in their names. It focuses on updates for the other modules instead. * CGI::WPM::Usage and CGI::WPM::CountFile have been merged into a single module, keeping the name CGI::WPM::Usage. This mainly consisted of copying about 6K of code into Usage and deleting the rest of CountFile entirely. CGI::WPM::Usage was further edited so that the new code integrated cleanly. The deleted module didn't really belong in the CGI::WPM::* name space, but was put there to get it out of the way of the generic name spaces, and because Usage depended on it. So there are now 8 CGI::WPM::* modules down from 9, and all of the remaining belong together. * All CGI::WPM::* modules have been updated to version 0.44. Most of the modules have had only minor tweaks that consist of renaming a few private methods (any leading "_" was removed for consistency). They should all work the same as they did before. * The ReadMe file was updated in several places, and there were other minor documentation updates. * Added demo SmartHouse - A Web-based X10 Device Controller in Perl. This demo is based on a college lab assignment. It doesn't actually control any hardware, but is a simple web interface for such a program should one want to extend it in that manner. This is meant to show how CGI::Portable can be used in a wide variety of environments, not just ordinary database or web sites. If you wanted to extend it then you should use modules like ControlX10::CM17, ControlX10::CM11, or Device::SerialPort. On the other hand, if you want a very complete (and complicated) Perl solution then you can download Bruce Winter's free open-source MisterHouse instead at "http://www.misterhouse.net". 2001-06-05 Darren Duncan <perl@DarrenDuncan.net> * Release 0.43. * CGI::Portable has been split into 5 modules, all of which are at version 0.43. The four new ones are [CGI::Portable::Errors, CGI::Portable::Files, CGI::Portable::Request, CGI::Portable::Response] and these handle most of the core functionality from the larger module before it. The new CGI::Portable module is a subclass of the above four and adds the remaining functionality itself; you can still use CGI::Portable as you did before. The split of functionality is to emphasize that CGI::Portable is doing several tasks in parallel that are related but distinct, so you can now use each of them independently and not carry around the weight of others that you don't use. Each module has the POD for all methods it implements. * The module CGI::WPM::SimpleUserIO has been rewritten and renamed to CGI::Portable::AdapterCGI. The new module has the same primary purpose but a simplified interface. The two methods which took CGI::Portable objects as arguments have been renamed to fetch_user_input() and send_user_output(). All of the other methods were removed except the send_quick_*() ones. Unlike before, it is fetch_user_input() that does the actual data gathering, whereas before it had to be done earlier with a separate method like new(). Unlike before, AdapterCGI sends all "http *" properties, including cookies. You will need to make slight changes to any "config shell" code that used the old module in order to stay compatible. All of the demo scripts and the Synopsis POD in the CGI::WPM::* modules have been updated for the new version. * Added module CGI::Portable::AdapterSocket which is like AdapterCGI except that it talks to an IO::Socket::INET object instead of a CGI environment, so the means is now provided for you to skip web servers altogether if you just need a lightweight Perl-only server. There is also a new demo script named startup_socket.pl which complements startup_cgi.pl in which they do the exact same thing (animals demo) but under different servers. However, this Sockets demo is fairly lightweight and doesn't have things like threading that the big servers do, so you would want to improve on it if you are operating in a heavy-use environment. * The "http cookies" property and associated methods that are now in CGI::Portable::Response have been greatly simplified so that they are easier to use and to eliminate external dependencies. While the property is still an array, each element is now a scalar instead of a MultiValuedHash object. It is assumed that users would encode cookies ahead of time and just insert them as strings; that is, the Adapter modules will send them literally. These methods have been removed: get_http_cookie_refs(), get_http_cookie(), get_http_cookie_ref(). The method get_http_cookies_ref() has been added to replace the first one, and it returns a reference to the whole list. These methods continue to work as they did before: get_http_cookies(), add_http_cookies(), delete_http_cookies(). * Added 8 new scalar properties to CGI::Portable::Request which hold extra miscellaneous HTTP request details: [request_method(), virtual_host(), server_port(), script_name(), referer(), user_agent(), remote_addr(), remote_host()]. AdapterCGI has been updated to feed them as well. Related to this change, [CGI::WPM::Usage, MailForm, GuestBook] have been updated to use these properties rather than looking in %ENV themselves, which wouldn't work if they were running in a non-CGI environment. * Updated CGI::WPM::Usage to lowercase all search engine keywords, and to do case-insensitive matching when determining search engine domains. The latter would be considered a bug fixed since other domain checks were c-i. * Some demo modules now require version 2.01 of HTML::FormTemplate since that version has some bug fixes. 2001-05-08 Darren Duncan <perl@DarrenDuncan.net> * Release 0.42. * Added a demo called "image" to show that, yes, CGI::Portable can store and output any type of file, not just HTML, but pictures and other binary types too. Contrary to some critics' statements, just because I don't use all the features that my modules provide in my own websites doesn't mean they aren't there. This demo script will generate an html page with text and an image, both of which are generated by the same script. This script requires the GD library to work so you'll need to have it installed to see the picture. * Added explicit support for the "Window-Target" http header to CGI::Portable, CGI::WebUserIO, and CGI::WPM::Base, which is needed for multiple frame pages where each screen can determine for itself what frame or window it goes into (meaning no messy target attributes in hyperlinks). To implement this, a new property was added to CGI::Portable with the accessor method http_window_target(). CGI::WPM::Base handles an additional preference named "http_target" which lets you set the new property. All three of the above modules were raised to version 0.42 from 0.41. Also, the "website" demo was updated to use this new ability by putting redirected links in a different window; that "website" change is also in the Synopsis POD for CGI::WPM::MultiPage, which is at version 0.4101. * Added explicit support for building HTML frameset pages to CGI::Portable in the form of two new properties with the accessor methods like page_frameset_attributes*() and page_frameset*(). These respectively hold properties for the opening <FRAMESET> tag and the list of <FRAME> tags. Also, a new "frameset" demo was added to show how one could use a single script to implement a frameset and all member frames. This demo has 4. * To help implement the frameset feature, this distribution now requires version 1.05 of HTML::EasyTags, which had frameset support added to it. * Fixed a bug in CGI::WPM::WebUserIO where redirection headers didn't work properly under mod_perl. In fact, this led to a complete rewrite of the methods relating to sending output. The methods make_http_headers() and send_user_output() were dropped entirely. These methods were added instead: send_quick_html_response(), send_quick_redirect_response(). The method send_user_output_from_cgi_portable() still exists and does everything it did before. It also outputs miscellaneous http headers now, but it still doesn't do anything with cookies yet. In the future this will be addressed. Since the last method is the only one I actually used in my demos or Synopsis, I figure that these changes are okay. I also added the method server_is_mod_perl() which returns true if we're running under mod_perl. * As a result of the above changes, HTTP::Headers is no longer used by any of my modules, so the requirements are now simplified. 2001-05-04 Darren Duncan <perl@DarrenDuncan.net> * Release 0.41. * This release is the first one following successful registrations with "The Perl 5 Module List". The updated entry would look like this: CGI:: ::Portable adpO Framework for server-agnostic web apps DUNCAND * This is the first release of CGI::Portable, which has been renamed from HTML::Application. There are several changes to the module itself. This release also includes all of my CGI::WPM::* modules, which have not been renamed, to serve as demonstrations of CGI::Portable in use. Their code has been updated a bit. Similarly, this distribution has been renamed to CGI-Portable from HTML-Application and duncand-prerelease. * This distribution now has a "demos" folder containing 40 files and folders which are ready-to-use example scripts and data files that exercise CGI::Portable and all of the CGI::WPM::* modules. Many of these are exactly the same as the *new* Synopsis POD for particular modules. Some have minor adjustments or demonstrate the Synopsis examples that make use of the most features of the particular modules. Many demos have extra files in them that never appeared in Synopsis. It is my hope that these demos will make it an order of magnitude easier for you to adopt my modules and put them to work in a productive manner. The provided demos include: a multi-page web site with usage tracking, guest books, mail and survey forms, static html and plain text pages, segmented text file display, redirection, and a few other strange modules that don't do anything useful but play with features. * All of the CGI::WPM::* modules except CountFile had their POD updated, most notably with their Synopsis section. The new Synopsis should each be complete working programs now, although some of the other data files they call on may not exist unless you make them. * All modules in this distribution are at version 0.41 whether or not there was any functionality change. * Updated these methods of CGI::Portable to permit more descriptive error messages: resolve_prefs_node_to_array(), resolve_prefs_node_to_hash(). Previously these methods always reported a nonexistant file or directory (whatever is in $!) even if the file did exist but had a different problem. The new versions will distinguish a successful runtime that returns something other than a hash/array ref, and will distinguish an existing file that just doesn't compile or has a runtime error. * Updated methods add_virtual_filename_error(), add_physical_filename_error() to support custom reason strings for file-related errors as an extra method argument. Previously the "reason" was always the content of $!. * Modified method call_component() so that it now makes error screens itself upon error conditions that it discovers, including failure of the component to compile or run, or previously unhandled errors, probably related to prefs. As a result, the calling structure of this method is simplified; you simply take_context_output() and/or send the output as you usually do, without needing extra code to report error conditions. (You can still make a custom error screen if you want.) The second argument to call_component() was also removed, and the method will now always make an error screen and return if there is an unresolved error message. Likewise to the simplified calling code, the called component doesn't need code to make an error screen for problems occuring prior to its invocation, and is thereby simplified. * Added method search_and_replace_url_path_tokens() to CGI::Portable that handles a special kind of search and replace that search_and_replace_page_body() can't handle, since it deals with processing and replacing text near the token being searched for rather than just the token itself. This method makes it easier to embed dynamic self-referencing urls inside static screen content files used by your app. * Added seven new methods to CGI::Portable which handle a special set of "global preferences", each of which gets its own accessor method, which can be set once and used all over your program. They are: default_application_title(), default_maintainer_name(), default_maintainer_email_address(), default_maintainer_email_screen_url_path(), default_smtp_host(), default_smtp_timeout(), maintainer_email_html(). The updated call_component() uses this information in its error screens, and the various CGI::WPM::* modules use it in many places as well. During release 0.4, this global info was passed using the miscellaneous objects property, which was a rather user-unfriendly means in comparison; scripts written to use release 0.4 will have to be updated accordingly. * CGI::Portable received several updates to its pod besides the appropriate method updates, most notably in the Name, Synopsis, Description, Similar Modules, A Different Overview. * Added a couple methods to CGI::WPM::SimpleUserIO which will considerably reduce the size of your config shell if you use them: the method give_user_input_to_cgi_portable() will take a CGI::Portable object and feed it all the user input possible at once; the method send_user_output_from_cgi_portable() will likewise take a CGI::Portable object and send its output to the user all at once. * CGI::WPM::Base has been reduced to half its size as all but these 3 methods were removed: main(), main_dispatch(), _get_amendment_message(). The code to check for pre-existing logged error conditions was also removed. * Updated CGI::WPM::GuestBook in the following ways: 1. The private method get_question_field_defs() had a lot of redundant code removed, reducing the method to half its previous size; for one thing, it makes use of CGI::Portable's resolve_prefs_node_to_array() method now instead of doing a poorer job of it manually. 2. Added preference "sign_by_default" which allows you to choose whether the signing or reading mode is the default when one isn't specified. 3. Added self-referencing links in the signing mode that takes one to the reading mode; the reverse had already existed; so now the module has built-in links between all of its modes. 4. Added preference "msg_list_show_email" which if true will display the email addresses of book signers in the reading mode; the default of not showing the emails is what always happened before, even though they were stored in the message file. 5. Minor update to the screen showing a successful message was just posted where the recipient's email is now shown. 6. Updated the functionality relating to the simplified Boulder data files (used to be called SequentialFile by me) where nonexistant files are only created if they are for storing messages; they are now not created when they were supposed to hold field definitions, since this is an error. * Updated CGI::WPM::MailForm in the same ways as #s 1, 5, 6 of GuestBook; regarding #6, MailForm would only ever read from such files anyway. * Updated CGI::WPM::Usage in the following ways: 1. Removed preference 'use_def_engines'; it no longer applies because there is no longer any list of search engines built into the module. To attempt such a thing here is an impossible task considering how many there are and people's varying opinions on what should be grouped there. So now if you want search engine differentiation in referrer listings then you can provide a complete list yourself via the already existing 'search_engines' preference. 2. Removed preference 'site_urls' since it had existed to make a big deal of something that is better automated and not worried about anyway. From now on, a referring url is said to be self-referencing if its base portion matches the return value of CGI::Portable's base_url() method. While a few self urls will undoubtedly end up in the normal referrer list, the majority will be caught, and the ones slipping through are easy to identify in the list. 3. As a result of these changes, CGI::WPM::Usage is now a tenth smaller. 2001-04-23 Darren Duncan <perl@DarrenDuncan.net> * duncand-prerelease 0.4, the last version of any distribution, prior to this one, to include the CGI::WPM::* modules, was released. 2001-04-23 Darren Duncan <perl@DarrenDuncan.net> * Release 0.4. * This is the second release of HTML::Application as a distinct module. It follows more extensive usability testing which resulted in a few added features and bug fixes. As a result of the new testing, this module is being moved to beta status from alpha. * Fixed SYNOPSIS POD in "Aardvark" module relating to the $inner context; some methods are now called following make_new_context() instead of before. * Fixed bug in private method _make_an_url(), which is used by url_as_string() and recall_url(), where query parameters were not being replicated when url_path_is_in_path_info() was true; now they are. * Fixed design flaw in make_new_context() where it had been calling initialize() to give default values to the new object before copying over the non default ones; now initialize() is not called and all object properties are either set or copied explicitely. The flaw being fixed relates to unpleasantries when a subclass overrides the initialize() method. * Added new method take_context_output() which is designed to complement make_new_context(). This new method copies output values from the new context back to the parent object. * Added new utility method search_and_replace_page_body() which takes a hash of tokens (or regexps) to search for in the html page body and text to replace them with; this method implements search-and-replace functionality. * This module has become 5K larger including documentation. 2001-04-20 Darren Duncan <perl@DarrenDuncan.net> * Release 0.38. * This release is the first one anticipating official registrations with "The Perl 5 Module List". The updated entry would look like this: HTML:: ::Application adpO Framework for complex portable web apps DUNCAND * This release contains the first appearance of my HTML::Application module. Its code is derived from several related modules which had been constantly renamed, split, and combined since their first CPAN release in 2000-07-23. The most recent temporary names for these were "CGI::WPM::Globals", "CGI::WPM::PageMaker" and "CGI::WPM::WebUserIO". They were previously released as parts of the following distributions: - "libdwg": v1.0 r2000-07-23, v1.11 r2000-08-23 - "CGI-FormGenerator": v0.9 r2000-09-04, v0.9201 r2000-12-26 - "CGI-WebsiteGenerator": v0.3 r2000-09-04, v0.36 r2001-04-10 - "duncand-prerelease": v0.37 r2001-04-12 * This module requires Perl version 5.004. * It also requires File::VirtualPath 1.0, HTML::EasyTags 1.04, Data::MultiValuedhash 1.07, and CGI::MultiValuedHash 1.07. I consider the first three modules to be stable and well tested, as well as unlikely to change. The fourth module is partially tested, but production use of the other functionality finds it to be working properly. * This release comes with the CPAN standard files "Makefile.PL", "test.pl", and "MANIFEST", which were all created since the previous release. * Note that "test.pl" is incomplete; it only tests that this module will compile but not that the methods work; it is included so that people can use the Makefile in the standard way during installation. This file will be fleshed out when I have the chance. 2001-04-12 Darren Duncan <perl@DarrenDuncan.net> * duncand-prerelease 0.37, the last version of any distribution to include CGI::WPM::Globals, was released. 2000-07-23 Darren Duncan <perl@DarrenDuncan.net> * libdwg 1.0, the first version of any distribution to include CGI::WPM::Globals and other CGI::WPM::* modules, was released on CPAN. 2000-05-15 Darren Duncan <perl@DarrenDuncan.net> * Completed primary development on these modules, but POD mostly nonexistant. 2000-03-07 Darren Duncan <perl@DarrenDuncan.net> * Began development on the final versions of these modules. * Module based on a template created by h2xs 1.18. 1999-07 thru 1999-12 * Worked on second prototype of code that ended up in these modules. The effects of this development, as far as this distribution's own modules go, were mostly confined to CGI::Portable. * As a separate but parallel project, I also implemented a complete and generic Threaded Discussion Board object using some of my low level modules *and* CGI.pm. This board is possibly still in use today in a corporate Intranet site. 1999-02 thru 1999-05 * Created first prototypes of code that ended up in these modules and used in a production environment for a year to generate my web sites. Many present-day features were present at that time, including static pages, segmented text pages, e-mail forms and guest books with unlimited questions (but were text only), redirection, and usage tracking. The implementation was just a hell of a lot uglier. These modules also used CGI.pm to do some things that have since become implemented by my own more focused modules: HTML::FormTemplate, HTML::EasyTags, Data::MultiValuedHash, CGI::MultiValuedHash, CGI::Portable, CGI::Portable::Request, CGI::Portable::AdapterCGI.