Coranto -- The Official Site

I'll be replacing some of our missing posts from the last few years, as I retrieve the necessary ones from the WayBack machine...here are the instructions for Distribution Packages.

I hope now that 1.25.2 is out, and the end of the dev line has been reached, that many of you will contribute to the Distribution Package Project. It only takes as long as it takes to set up your Coranto for whatever package you have in mind.

Two things to be aware of:

1) Please write a step by step manual installation procedure, for users wishing to install the package onto an existing Coranto install. This will be important, in that it offers another solution to many common questions. The distro packages can double as a How-To for new users.

2) Please include Version notes as seen below, with credits to original authors, etc.

3) To release the package, nsettings.cgi will need to be edited. Instructions for that are also included below.

Please check the below information, and contribute as possible.

Version Notes Format
(using Basic Cal as the model, since I done got it here!)

Feel free to cut and paste this into your Notes:

Code: Select all

#################################################
#          Coranto Distribution Package
#################################################
#
# CDP Title:       Basic Calendar
# CDP Version:       0.1.0
# CDP Description:    Basic Calendar Setup for Coranto using smcCalendar for Coranto v 1.0.
#               Alternate Instructions included for manual install onto a previously installed Coranto,
#               as well as calendar documentation for customized integration.
#
#   CDP Assembler:      Jackanape
# CDP License:       All Coranto Distribution Packages are released under the same license as the Coranto Core,
#               the MIT License, found here: http://www.opensource.org/licenses/mit-license.php
#
#################################################
#         For the latest version of this and other Coranto Distribution Packages,
#         as well as support, please visit http://www.coranto.org 
#################################################
#   CDP History:
#
#         23-08-2008     Version 0.1.0
#               Initial release - bare bones version
#
#################################################
#   Included files, addons, and credits:
#         We would like to thank the following people for their contributions to the various ingredients that make up this          #         CDP--their generous contributions to the internet community, and Coranto specifically, are greatly appreciated.
#
#         smcCal Script      Scott Crevier          http://www.webmaster.crevier.org/
#         smcCal for Coranto   Parahead, Dale Ray, Jackanape   https://sourceforge.net/projects/corantoaddons/
#         X Multisubmit      L0rdphi1, Lawrence, Parahead & InSAnE NiNjA
#         CustomFields      Parahead
#         ChangeDateNew      Parahead            http://www.parahead.com   
#         Sort Orders      Lawrence, Parahead
#   
#################################################
#         Notes:
#
#         This remains a work in progress, and all contributions are welcome!
#               
#################################################

Installation Instructions:

1) Follow standard Coranto Setup Procedures.

2) Once Setup is complete, login with your admin user account.

3) That's it!  You're ready to use your new calendar!

How To Create a Coranto Distro Package

####################################################
### ###
### How to make Coranto Distribution Package ###
### ###
####################################################


1) Set up and configure your package

2) Open nsettings.cgi

3) Remove your sessions data.

Find:

"Sessions``xcttawwiwdjOttDENWJ!x!(username)!x!9f7750f8e2f8aa7feb2134114d8414efc313d57d!x!127.0.0.1!x!bwWvkj!x!1220455675"

Change to:

"Sessions``x"

4) Remove your userdata.

Find:

"userdata``x(username)"

Change to:

"userdata``x"

Find:

"user-(username)``xCPassword!x!9f7750f8e2f8aa7feb2134114d8414efc313d57d|x|UserLevel!x!3|x|Email!x!baby@daddy.com|x|LastLogin!x!1220448475"

And DELETE.

5) ADD the following lines:

"firsttime``xyes
ForceFullBuild``x1"

Your distro package should be reset and ready to distribute to fresh installs.

A Step-by-Step example

(Also from basic cal)

Based on the old KISS format (Keep It Simple, Stupid)

Code: Select all

1)Download smcCal for Coranto and extract contents into "calendar" directory (usually in your cgi-bin)

2)Install and Enable the Following addons: ChangeDateNew, CustomFields, News Categories (ncluded in standard Coranto Distribution), SortOrders, X Multisubmit

3)Create News Category "calendar"

4)Create the following new fields:
   Name:         Display Name:   Field Type:      Value:
   CustomField_date       Date      Single-Line Text Field
   CustomField_time       Time      Single-Line Text Field
   CustomField_venue      Venue      Single-Line Text Field   
   CustomField_reminder1    Subject Reminder   Description Field      Enter your Subject as you want it to                     
                              appear on your Calendar and event list.
   CustomField_reminder2    Date Reminder   Description Field      Remember to enter the date of the game in
                              the Above box, in the proper format.   

5)Create X Multisubmit Profile "Schedule":
   Profile Description: Remember to enter the date of the game in the Above box, in the proper format.
   Lock to "calendar" category
   Include following fields with order values:
      Field:         Value:
      Date            10
      Date Reminder         20
      Subject         30
      Subject Reminder      40
      Time            50
      Venue         60
      News Text         70
     
   Require Fields according to your needs -- I used Date, Time, Subject and Venue
   
6)Create the following styles:

   "calendar":
   
   <Field: Year><Field: TwoDigitMonth><Field: TwoDigitDay>^^^<Field: Subject>^<If: Field: Text>#newsitem<Field: newsid></If>^

   ***CRUCIAL***
   Don't forget to hit return to add a linebreak at the end of your style.  Your calendar will not work without the new line present.

   "dates":
   
   <PerlCode>$which = $lfcnt{$ProfileName}++ % 2 ? 'right' : 'left';</PerlCode>
<div style="float: <Field: which>; clear: <Field: which>; background: #669966;">
<h4><Field: CustomField_date></h4>
<h4><Field: Subject></h4>
<h5><Field: CustomField_time></h5>
<h3>At <Field: CustomField_venue>:</h3>
<center><Field: Text>
<hr />
</center>
</div>
<If: Field: which eq "right"><br clear="all" /></If>

7) Create and enable the following profiles:

   "calendar":
   File Name: default_dates.txt
   File Path: (your calendar path--often cgi-bin/calendar/)
   Leave Filter by Time BLANK
   Categories: calendar
   XMS Profiles: schedule
   News Style: calendar
   Display Coranto Link: OFF
   Anchor Tags: OFF
   
   "dates":
   Default File Settings are fine--depending on your personal installation
   Categories: calendar
   XMS Profiles: schedule
   News Style: dates
   Display Coranto link: ON (please?)
   Sort Order: Default
   
   (You can, if you wish, change your output to sort by venue and date, etc.  This is why SortOrders has been included in this package.)

8) Edit the calendar.shtml includes to reflect your calendar and dates.txt paths.

9) Submit a couple of events, and check out your handiwork.  You're all set.

N.B:
The CSS for your output can be found in calendar/cal_header.tpl and calendar.shtml, respectively.  The styles in this package are simple default offerings, and the end user is invited to edit the CSS, and place it all with their main CSS files, or to incorporate the code to their needs.