Information sur les auteurs & la licence

=======================================

INSTALLING THE PostNuke phpcomic MODULE VERSION 2

by ramses.the1st@free.fr

=======================================

NOTE: This module has been tested on Postnuke .750 and .760 RC2 and RC3


1) Unpack the files in your html/modules directory. The phpcomic directory
will be created there. The phpcomic directory should be "phpcomic" lower-case.

2) Browse to your Postnuke site and click on Adminstration->Modules.
Then click on "regenerate" to add the phpcomic modules to your site.
Click on "initialise" for the phpcomic module.
Click on "activate" for the phpcomic module.

3) create a phpcomic subdirectory in your pnTemp directory and CHMOD it to 755

3) Your phpcomic module is now available and ready to use.

4) Create a link in your menu block with {phpcomics} (curl braces not straight ones
this is a change from the previous version)

5) That's all!

6) A number of options and comics management are available in the phpcomic
Administration panel :
# of comics per page
Name of cache directory (relative to pnTemp, default : phpcomic)
Method to check for updated comics (change with date or change after seconds)
Interval to cache comics in seconds if you choose the "change after seconds" option

You can also enter url and port of your proxy if your webserver in on a network that
enforce the use of a proxy foe external http connexion.
WARNING in most case this is unneeeded and all these fields should be left empty.
Entering wrong data in proxy host or port will result in the module not been able
to grab any comics.
If in doubt consult the network administrator of your webserver's network.


=================================================================

UPGRADING FROM VERSION 1.02

=================================================================

Warning : the method GrabSimpleRegexp to grab comics is no more supported in
this version. In the original phpcomic 1.02 only Badlands, World
of Lily Wong and Sluggy Freelanceand Little Gamers use this method.
World of Lily Wong and Badlands are no more published, and if you want
I can give you new parameters for Little Gamers and Sluggy Freelance.
Of course if you have added other comics using the GrabSimpleRegexp method,
be warned that they will not work after upgrade.

As the module is now a "new style one" all your url and links will need to
be updated from your_site/modules.php?op=modload&name=phpcomic&file=index to
your_site/index.php?module=phpcomic&type=user&func=main (func=view will also
work)

In the menu block (Administration -> Blocks) you will need to change [phpcomic]
to {phpcomic} (curly braces)

You will need to create a phpcomic subdirectory in your pnTemp directory
and chmod it to 777 to store the comics images.

The upgrade will deeply change your phpcomic table because each comic is
now indentified by a number rather than by a string (was needed for future
modules in PostNuke .8 to work so I choose to do the change now).
If you have customized phpcomic 1.02 and added some comics, I strongly
urge you to do a backup before upgrade.

Users of PostNuke .750 will most certainly encounter some problems in upgrade
because PostNuke .750 doesn't handle well the upgrade of an "old type" module to a
new one. If you have not added any new comic to phpcomic 1.02, the easiest way is
certainly to remove the old phpcomic 1.02 and do a fresh install of phpcomic 2.0 !!
If you have some customized comics that you don't want to loose, you can replace
the your_site/modules/Modules/pnadminapi.php file with the same file extracted
from the PostNuke CVS a few weeks after the release of PostNuke .750 because
the developpers of the PostNuke team made the changes needed. If you choose
this way just ask and I will send you the right pnadminapi.php to upload in
your_site/modules/Modules/ directory.
If you don't want to alter a core PostNuke file, another way is after the
upgrade of phpcomic if somethiing went wrong (most certainly it will be the
case) to use phpmyadmin to browse the nuke_module table, find the record
with pn_name=phpcomic and edit it to change pn_type to 2 and pn_state to 3.
In any case as you will have a backup of your nuke_phpcmic table you should
not, even in the worst case loose anything !

Users of PostNuke .760 should not experience any problem.

Upgrade procedure

- delete the modules/phpcomics directory and all its content on your server
- upload the new phpcomic directory and all its content to your server
- Go to Administration -> Modules click on regenerate
- On the phpcomic line, click on initialize then activate

ImPORTANT - IMPORTANT - IMPORTANT - IMPORTANT - IMPORTANT - IMPORTANT
Remember that clicking on remove in Administration -> Modules on the phpcomic
line now remove not only the module but also all the tables and their content
(this was NOT the case with phpcomic 1.02)

=================================================================

TIPS

=================================================================
As the module is fully templated you can completely customise the display
editing the files in pntemplates. Of course a little smarty knowledge is
required.

I wrote a doc : "How to grapb comics" in the hope to teach phpcomics users
how to add their own comics to the phpcomic module.

King Feature comic are now working, I let you discover the parameters with
the help of the "How to grab a comic" text.

The module fully support hooks modules but I had some problem with old versions
of ratings and EZComments. Everything seems OK with Ratings from PostNuke .760
and EZComments 0.6

Enjoy.

Disclaimer : the legislation about copyright, authors and editors rights
vary greatly from country to country. It's up to you to ensure that using
this module you respect all applicable legislations .

Thanks a lot for your interest in my work.
I am very interested in your comments.
ramses