view release on metacpan or  search on metacpan

migration/README  view on Meta::CPAN

Migration from 1.09 to 1.10

=============================================================
Migration from 1.08 to 1.09

1. Static pages can be protected with the reqire_login attribute in the
	Config.xml page and section tags. This is enabled by default.
        If you want backward compatible or you do not want to protect
        static pages, set the global option protect_static="no".

=============================================================
Migration from 1.07 to 1.08

1. Remember that you need libxml2 >= 2.4.10, libxslt >= 1.0.9,
	XML::LibXML >= 1.31 and XML::LibXSLT >= 1.31

2. Apache::SessionX replaces Apache::PageKit::Session.
	For now you can also choose your Session-Toolkit with
        the global config options:

        session_class = 'Apache::PageKit::Session' and
        page_session_class = 'Apache::PageKit::Session'

	this settings choose the old Session class, but the old class
	might go away in the future.

3. inside the hook pkit_cleanup_code it is impossible to use $model->session
	and $model->page_session. They are already deleted. If you have to use
        one of the session objects that late, use pkit_post_common_code. 

=============================================================
Migration from 1.06 to 1.07

1. The returncode from your pagecode is now ignored. If you have to set such
	a code, see $model->pkit_status_code;.

=============================================================
Migration from 1.05 to 1.06

1. __PACKAGE__ is not interpolated run
2. The PKIT_COMPONENT tag did NOT support a single unnamed parameter anymore.

	<PKIT_COMPONENT filexx>

        changed to

        <PKIT_COMPONENT NAME="filexx"/>

3. Digest::MD5->md5_hex changed to Digest::MD5::md5_hex in Common.pm
4. MD5->hexhash changed to Digest::MD5::md5_hex in MyModel.pm
5. Remove some possible "use undefined" warnings
6. Write "use Digest::MD5 ();" before "use DBI;"

run
migration/migrate_pagekit_1.05_to_1.06.pl /path/to/pagekit_root

=============================================================
Migration from 1.04 to 1.05

1. pkit_done parameter is no longer automatically filled in HTML
	Forms.  So if you have HTML code that looks like this:

	<input type="hidden" name="pkit_done">

	Change to

	<input type="hidden" name="pkit_done"
		value="<MODEL_VAR NAME="pkit_done">">

=============================================================
Migration from 1.02 to 1.03

1. XSL files are now located in View/pkit_view directory instead of
	View/pkit_view/XSL.  Simply move all files out of the XSL
	directories into their parent directiories.  If you don't have
	any XSL files, skip this step.

=============================================================
Migration from 0.99 to 1.00

1. Several of the <PKIT_*> tags have changed.  To update the templates
run
migration/migrate_pagekit_0.99_to_1.00.pl /path/to/pagekit_root

=============================================================
Migration from 0.98 to 0.99

1. The View/Component and View/Page directories have merged into one
directory under View.  To merge the templates, run
migration/migrate_pagekit_0.98_to_0.99.pl

2. <PKIT_VAR NAME="SELFURL"> has been changed to <PKIT_SELFURL>
You can apply this change easily by running from the View directory:

cd /path/to/pagekitroot/View
perl -pi -e 's!<PKIT_VAR +NAME *= *"?SELFURL"? *>!<PKIT_SELFURL>!gi' \
	`find . -name "*.tmpl"`

3. $model->input_param has been changed to $model->input for getting
	request parameters and $model->fillinform for filling in HTML forms
	and $model->pnotes for passing around data between different handlers

	$model->output_param has been changed to $model->output

4. $model->input_param('pkit_user') and $model->output_param('pkit_user')
	is no longer set by authentication code.  Instead, set
	$model->pnotes(pkit_user => $pkit_user) in your
	pkit_auth_session_key in your model code and use
	$model->pnotes('pkit_user') to access the set value

=============================================================
Migration from 0.97 to 0.98

1. Apache::PageKit::Error has been renamed to Apache::ErrorReport
If you use PerlSetVar PKIT_ERROR_HANDLER anywhere in your httpd.conf
file, you should change it to PerlSetVar ErrorReportHandler

You can do this easily by running:

perl -pi -e 's/PerlSetVar PKIT_ERROR_HANDLER/PerlSetVar ErrorReportHandler/g' httpd.conf