Installation of PostCalendar is easy and painless.

Because we have followed the pnAPI and pnMDG, it is completely compatible with PostNuke 0.71 and future releases.

The steps needed to install PostCalendar are:

• You agree to be bound by the GPL license.
• untar or unzip or upload the PostCalendar distribtion into your /html/modules directory
• Two directories need to be changed to world readable and writable, these are:
  • /html/modules/PostCalendar/pntemplates/cache, and
  • /html/modules/PostCalendar/pntemplates/compiled
  • In *nix, you would “chmod 777 cache compiled” This will allow the Smarty Template Engine to read and write from/into the cache and compiled directories. If you would like to change the path of these directories, you can change the value of $this→compile_dir and $this→cache_dir in the pcSmarty.class.php file to point to wherever you’d like templates to be compiled. Moving this out of the webroot might not be that bad of an idea.
• Now enter the PostNuke Modules Administration page:
  • Administration → Modules
  • Select the “Regenerate” link at the top of the page. This will “find” the PostCalendar module and you will see it in the modules list. It should say “Uninitialized” next to its name.
  • Click on “Initialize”, this will then automatically generate all the necessary tables, add PostCalendar specific variables in the module tables, if successful, you will get a “Module Initialized Successfully, now inactive” status message at the top of the Module Administration page.
  • Now scroll down the page until you find the PostCalendar entry and click on “Activate”
  • Again PostNuke should reply with a status message that all went well.
  • That’s it! PostCalendar is now installed on your system and you’re ready to use it. Please read both the “Block installation and configuration as well as the PostCalendar configuration” sections in this manual for the next few steps to a fully functional PostCalendar installation.

The PostCalendar Block installation follows the norms of PostNuke. But UNLIKE other blocks, you can have as many PostCalendar blocks on your site as you like! For instance you can have a center PostCalendar block displaying only today’s events, another just displaying the upcoming events another displaying the mini month calendar and yet another displaying all three... talk about flexibility!

• To add a PostCalendar block to your site, go to the PostNuke administration section and select Block and then New Block.
• The initial block configuration form appears, now enter a Title for your block, let’s say PostCalendar
• Select “PostCalendar/Calendar” from the Block pull-down menu
• Select the language you want this block to belong to
• Click “Commit”

Now the PostCalendar Block configuration form appears where you can enter the Title, Position and Language here again (if you made mistakes in the block definition form I guess)

• If you want your PostCalendar Block to display the mini month calendar then select the check box against “Display the calendar?”
• “Display today’s events in the block?” allows you to select whether you want Today’s Events to be displayed in the block.
• “Display upcoming events in block?” allows you to select whether you want to display the future events.
• Do you want your users to have a quick access to search and submit events directly from the block? If so, select “Show search/submit links in block?”
• How many of Today’s and Upcoming events (individually) do you want to display in the block? Enter the number against “Display how many events?”. If you selected “5” here then 5 of today’s events AND 5 of the Upcoming future events will be displayed in the block (assuming that you are displaying both today’s events as well as the upcoming events in the block.)
• “How many months ahead to query for upcoming events?” This is a nifty new feature of PostCalendar, now you can select how many months ahead do you want PostCalendar to search and display in the “Upcoming Events” section of the block - very neat!
• Once you’re happy with all your selections, click the Commit button and the block will be created for you. You can of course go back to your Block administration screen and move the block up or down as per PostNuke’s procedures.
• “Refresh time for block (only used for blocks that pull information from outside sources)” Is not needed (yet!) in PostCalendar, so just leave it at default.