Instructions and remarks on
release of PagEd 0.93

Alpha/beta releases of PagEd should be treated as potentially buggy and should be applied to production sites only after backup.

This document is only a quick introduction to PagEd. But there are several other sources of information that you may use:
* Once you have installed PagEd. turn to your PagEd Control Panel and press the Module Settings button. At the top there will be a prompt to install a help set. Click on this link. The page reloads. You should now see small clickableb help icons in most places around the module.
* The main PagEd site offers a forum, a FAQ, some articles, and also a user-built manual (PagED Wiki Manual) where information can be found.

Contents

If youre not a big fan of manuals, or if reading them does bad things for your credibility, consider browsing the items marked with *** anyway. We wont tell anyone.

Installation
*** New install
Or *** Upgrade
Admin panel icon
*** Image handling
Deprecated files

Features
News display
PagEd as front page
Control panel block
All-topics block
Content block
***Single-topic block
Selectable topic header article
*** Edit permissions
*** Read permissions
Local/external image linking
Database backup manager
Extras
Commenting news and articles
Advanced Search Block support
Addon for pnTresMailer news letter module
Photoshare integration
RSS backend file for news syndication

Miscellaneous
Known issues
Check for updates
Forum
Crisis and PHP-info
Credits


Installation: New install

Unzip and upload folder modules/PagEd into YourSite/modules folder.
Upload file includes/search/pagedsearch.php into YourSite/includes/search folder.
Upload file pagedbackend.php into YourSite (root) folder.
IMPORTANT: If you plan on using NetPBM for image resizing, download the correct netpbm library pack for your server OS: Either Unix/Linux, Windows, MacOSX, Solaris or FreeBSD. Unzip and upload into PagEd folder as folder “netpbm”.
NOTE TO ENVOLUTION/MD-PRO USERS: After initializing/activating PagEd, you must add the module to an admin group before the admin icon is visible. Turn to eNvolution/MD-Pro admin, scroll to Edit Admin and press this. In the next panel, scroll to where it says "PagEd v.0.93a" and select a group to place PagEd under (for instance Content), and submit your selection. The PagEd icon should now be visible under eNvolution/MD-Pro admin/the group you selected.

File and folder permissions:
Apply CHMOD 777 to the following folders:
PagEd/backups
PagEd/browsepics
PagEd/dummypics
PagEd/editorpics
PagEd/media
PagEd/medipics
PagEd/pictures
PagEd/thumbnails

Apply CHMOD 755 to the following, if present:
PagEd/netpbm
All files inside this folder
All this will be checked during the install process!

If your tables for some reason were not created, you can create them manually by importing the sql-dump PagEd093.sql in this docs folder. Before doing this, do a search-and-replace on the "nuke_" prefix with your own database prefix, if you have a different one.      

>>>Top of page


Installation: Upgrade

Upgrade process: Unzip and upload module files into existing PagEd folder. Image folders and netpbm folder need not be replaced. Then, go to your Postnuke/eNvolution/MD-Pro admin panel/modules, regenerate. The PagEd entry MAY say "New version installed". If so, press "upgrade" and then "activate". This does NOT trigger database upgrade changes.
You can now continue to use PagEd normally. Once you do, any necessary upgrade changes are done in the background. If the process should be unsuccessful, an error report will be displayed.      

>>>Top of page


Admin panel icon

This PagEd module pack is intended to work under both Postnuke, eNvolution and MD-Pro. Therefore, two different admin panel icons are included. To display one of them, turn to PagEd/images and change the name of either adminpn.gif (Postnuke) or adminenvo.gif (eNvolution, MD-Pro) to just admin.gif. In folder PagEd/pnimages, do the same.      

>>>Top of page


Image handling

NOTE:PagEd offers a flexible way of resizing images according to taste. Should you find the functionality not working, please make sure you have installed and configured as mentioned here.

PagEd offers 2 options for handling/resizing images:
1. PHP`s built in image handler, GD. Most web providers offer this as default. PagEd will find it, if present.
2. NetPBM. You must install this separately, but the process is not difficult: Download from the PagEd site, unzip and upload as folder "netpbm" into the PagEd folder. CHMOD according to details mentioned above in this document.
GD vs NetPBM:
Many web providers run PHP in Safe Mode. If your provider does, GD is your only option.
GD does however not handle gif images. NetPBM does. Using GD with PagEd means you will have to convert your gifs to png before using in content creation.
Please turn to the PagEd site for more info on image handling. The speed and quality of the two are fairly equal.

>>>Top of page


Deprecated files

The following files were included with PagEd in earlier releases, but may now be deleted, as they are no longer used:
PagEd/pagedbackend.php (now in root folder)
PagEd/pnadmin.php IMPORTANT!
PagEd/setuseraccess.php
PagEd/showimage.php
PagEd/storeimage.php
PagEd/storemenucontent.php
PagEd/showimage.php
PagEd/showimage.php
     

>>>Top of page


News display

Please read the FAQ at PagEd web site for how-to information.      

>>>Top of page


PagEd as front page

This is easily set in Module Settings. Select a PagEd article or PagEd news. Should you wish to go back to Postnuke News as your front page, this is the first alternative on the drop-down list of pages in PagEd Module Settings/Front page.      

>>>Top of page


Control panel block

A small PagEd control panel block can be created in site admin/blocks/new block. This will give you quick-links to the main editor panels wherever you like on your front page.      

>>>Top of page


PagEd AutoContent Block

This block can be used in a number of ways. Create one and have a look at the options.      

>>>Top of page


Topics menu block

In order to make the PagEd topics feature more useful, you can now create a topic menu block. In your site admin/Blocks/New block, select the PagEd Topics Block and place where you like (left, center or right). This block is not configurable, but will display as a listing of all topics viewable, depending on the user`s language. A user browsing in English will see all topics connected to “all” languages and “eng” languages, etc. IMPORTANT: You do not have to select a specific language for the block, as the block will only display links according to the user language.
The topic menu block lists topic titles. These are links and will take you to a main page for the selected topic, where all pages under the topic are displayed.     

>>>Top of page


Single-topic Block

Create this block if you want a topic overview displayed in a block instead of a full page.
IMPORTANT!
Earlier PagEd versions created single-topic blocks manually by writing code to new files in Paged/pnblocks. Should you have such blocks in use, named paged1topic.php, paged2topic.php etc, you may experience display errors in 0.93.

To fix this, please do the following:
1. Delete file PagEd/pnblocks/paged1topic.php (or paged2topic.php, or...)
2. Enter your site admin panel/Blocks
3. Create a PagEd Single-topic block
4. Select topic 1 to display (or 2, or...).
The reason for this change of functionality is to keep single.topic code uptodate and to avoid file writing.      

>>>Top of page


Selectable topic header article

The topic overview feature gives you a listing of all articles under a topic. You can place one article above the others by selecting this in Edit Topic. This article will be shown in full, and can be used as a presentation of the topic, or as a Top Story.      

>>>Top of page


Editor permissions

From the Group Manager, displaying all groups on your site, you can proceed to edit permissions for a single group. In Edit Permissions, it is possible to define edit access only to many aspects of operation. NOTE:For read permissions, see next section.      

>>>Top of page


Read permissions

PagEd supports the Postnuke/eNvolution/MD-Pro permissions system for user-dependant display. The correct syntax in permissions is:
Blocks:
Group   PagEd::   Block Title::   Access

Single pages:
1. Group   PagEd::   Page:Page title:   Access
2. Group   PagEd::   Page:Page ID:   Access

Topics:
1. Group   PagEd::   Topic:Topic title:   Access
2. Group   PagEd::   Topic:Topic ID:   Access

Menu links::
Group   PagEd::   Node:Link title::   Access

Remember the general Postnuke importance of permissions ordering!!!      

>>>Top of page


Local/external image linking

If you need to add images in PagEd which are stored outside the PagEd/pictures folder, enter a local or external path in Edit Content or Edit Topic. External (from other web sites) images will be imported into the pictures folder.      

>>>Top of page


Database backup manager

A database backup manager is now accessible from the Control Panel. It gives you the option of either backing up PagEd tables or all tables in your CMS installation. Backups can be stored as text files in the PagEd/backups folder, and/or sent to a specified mail address, configurable in Module Settings..
The Backup Manager can be set to automatic operation also. See Module settings, last section, for this.      

>>>Top of page


Comments

A separate module exists to add comment functionality to PagEd. If you want to give users/guests the ability to comment PagEd content, download the EZComments module from http://postnuke.lottasophie.de. Place in modules folder, initiate/activate. You will NOT see any module icon for EZComments. To enable comments in PagEd, go to your eNvolution admin panel/modules, scroll to PagEd, select "Edit" and check the "Activate ezcomments for this module" box. Full page display of PagEd articles will now be followed by a comment field. Comments are not stored in PagEd tables, but in the EZComments table.      

>>>Top of page


Advanced Search Block support

PagEd now supports the Advanced Search Block from http://warpspeed.4thdimension.de/index.php. This block is created and configured in eNvolution admin/blocks.      

>>>Top of page


Addon for pnTresMailer news letter module

PagEd now supports the news letter module pnTresMailer, also downloadable from from http://canvas.anubix.net. To add PagEd functionality to this module, get the addon script from Downloads/PagEd/Addons. Place in html/modules/pnTresMailer/modules folder.      

>>>Top of page


Photoshare support

Photoshare, Jørn Lind-Nielsens photo handling module, offers support for letting other modules browse it`s images. PagEd tries do complete this friendship by adding the necessary browsing code.
- How to: PagEd sniffs for the presence of Photoshare and will display a browse button if the module is found. If you are not running Photoshare and would like to try this feature connecting the modules, see site URL below and follow instructions for normal module installation. Note: Must be v. 3.1 or later. The moment your Photoshare is installed and present in your Postnuke admin, PagEd will see it and take care of the rest. Photoshare site: http://www.elfisk.dk      

>>>Top of page


RSS backend file for news syndication

PagEd now comes with a backend file for news syndication. If you are running PagEd with the news block on site A and would like the news displayed also on site B, create an RSS block in eNvolution admin/Blocks on site B, and enter the URL http://siteA/pagedbackend.php. Place the block wherever you like.      

>>>Top of page


Known issues

- The permission system in PagEd has been improved and made more fine grained, but access according to set permissions may still be buggy. This is one of the main issues to report in forum, if you find bugs!
- Import Content (from PN or EZCMS) imports text and image names, but images must be copied manually to the PagEd pictures folder. Hopefully this can be automated in a later release.
- If you are upgrading, the "Link to original size images: Image itself, text below or no link" setting for pages will probably be lost and will have to be reconfigured.
- Module relies on PastNuke module, and it is not yet PNAPI-compliant. But work on this is in progress.
- Javascript popup menus might not work in all browsers (although they are meant to!). There is a known problem with Opera before v. 7.      

>>>Top of page


Check for updates

The PagEd control panel now has a "Check for updates" button which will open up a popup window with the latest information on 0.93. Click this button from time to time to keep updated!      

>>>Top of page


Forum

A forum for PagEd is up and running at PagEd web site . Have a look!      

>>>Top of page


Crisis and PHP-info

If you experience a serious error with PagEd, you can access a support form from the Control Panel/Bugs and info section, or via a link at the PagEd site. However, please use this option with restraint, as support time is limited. For most problems, the forum will give you faster feedback.

PagEd comes with its own PhpInfo feature. This is disabled and not configurable in Module Settings, for security reasons. However, if you would like to be able to access this feature, change PagEd/setmodule.php, about 15 lines from the bottom, to
$showphpinfolink=1;
A link to phpinfo will now be visible in Module Settings. It is probably a good idea to roll this back to $showphpinfolink=0;
after use.      

>>>Top of page


Credits

Thanks to all for support and suggestions so far! Keep them coming. So many have contributed in the past, that for fear of forgetting someone, I will only thank you all. And thanks to Mr. Herald of EZCMS for laying the work this module is based on.

Øivind Skau
ors@anubix.net
25.06.04

If you like PagEd, why not have a look at our other modules:
PnTresMailer, the advanced newsletter module, configurable, expandable and able to handle heavy traffic.
Nubel, a translation tool for your Postnuke/eNvolution/MD-Pro installation.
Site URLs, as with PagEd: http://canvas.anubix.net      

>>>Top of page