|DySE::Calendars Script : Documentation|
The DySE::Calendars script (make.pl) is a Perl script program that works in conjunction with the generic DySE viewer script (view.pl) to display products offered by Calendars.com. The DySE::Calendars script and the DySE viewer script run on your web server.
When you run the DySE::Calendars script (make.pl), it downloads and processes the product datafeed file from Calendars.com and creates a products database file. When a user visits your website, the DySE viewer script (view.pl) is run and it displays product pages, category pages, or the home page.
A live example website that uses DySE::Calendars is Great-Calendars.com
Affiliate of Calendars.com:
To use DySE::Calendars, you must be an affiliate of Calendars.com at either: ShareASale.com, CJ.com, or Google Affiliate Network (GAN).
If you are already an affiliate then skip down to Step 2 "Datafeed" below. Otherwise, sign up with Calendars.com at one of these affiliate networks (if you have no preference, we recommend ShareASale.com):
You must manually obtain the Calendars.com datafeed. Unlike other DySE scripts, the DySE::Calendars script will not automatically download the datafeed for you.
Note: You must use the datafeed supplied through the affiliate network (ShareASale.com, CJ.com, GAN) that you are signed up with. The format of the datafeed from each network is different and will only work with that network.
Note: DySE::Calendars auto-detects which affiliate network (ShareASale.com, CJ.com, GAN) the datafeed is from. And it also
auto-detectswhether the file is CSV, tab-delimited, or bar-delimited. XML format is not supported.
Obtain the Calendars.com datafeed:
Note: It is up to you to unzip/gunzip the datafeed file received from GAN/CJ.com/ShareASale and to rename the uncompressed datafeed to datafeed.txt. DySE::Calendars does not work with compressed files.
- Login to ShareASale.com.
- Under the heading "Get Links", click "Datafeeds".
- Enter "calendars" as the keyword and press Enter key or click "Refresh Report" button at right.
- Scroll down to the report, and in the "Datafeed Info" column, click on "Download .csv".
- On the next page, at "Please click here to download the file", click on "here" link.
- Save the 17483.zip file to your computer.
- Unzip 17483.zip to get 17483.txt
- Rename 17483.txt to datafeed.txt
Contact CJ.com and ask for a "Product Catalog (Data Feed)" subscription to be set up for your CJ.com account. See CJ.com's "Scheduled Data Transfer Guide". We recommend:
- Client FTP (so the datafeed is uploaded to your server).
- Comma-delimeted (CSV) format
GAN does not charge for datafeeds. The datafeed will be automatically uploaded to your server on a daily basis.
- Login to GAN, click Links tab, then click Product subscriptions in left sidebar.
- Click "Subscriptions settings".
- Click the Calendars.com datafeed and add it.
- For the FTP Information, enter your FTP login information.
- For the File Name and Extension, select "Advertiser Name".
Upload the Calendars.com datafeed:
When you install DySE::Calendars, you will end up with directory
cgi-bin/dyse/calendars/in which you will need to create a directory called data that is to contain the datafeed file datafeed.txt
- Run your FTP progarm.
- On the server side, go into the directory
cgi-bin/dyse/calendars/which you created when you installed DySE::Calendars.
- Create a sub-directory called data
- On the server side, go into the data directory.
- On the local side, go into the directory where you saved datafeed.txt.
- Upload datafeed.txt into the data directory.
Without a DySE::Calendars software key file, DySE::Calendars runs in demo mode. If you want to try out DySE::Calendars in demo mode, then skip down to step 5 "Configuration" below. You can obtain a key later.
Click here to purchase yearly license
To request a DySE::Calendars key file, click here.
After we have processed your key request, we will email your DySE::Calendars key file to you.
In the mean time, you can continue with the installation so you can do customization and experiment with DySE::Calendars. Then later on when you receive your key you can install your key.
Depending upon what day of the year you run the DySE::Calendars make.pl, calendars can be included from: the current year and/or the next year. Note: Previous year calendars are never included (e.g.: After 31-Dec-2009, the 2009 calendars are not included).
The default configuration is:
- Current year calendars are included if tody is August 31st or earlier (i.e.: the 8th month or before).
- Next year calendars are included if today is July 1st or later (i.e.: the 7th month or after).
If you want to change when the current year calendars and/or the next year calendars are included, then you should read the "Configuration" section below after you have completed the installation.
For detailed instructions on how to install and use DySE::Calendars make.pl and the DySE view.pl,
Ths section is optional. You only need to read it if you want to change when the current year calendars and/or the next year calendars are included.
Do the following steps to change when the current year calendars and/or the next year calendars are included:
Create a text file called make-ini.txt that contains the following configuration variable setting:
The data.year.current specifies the maximum month to include current year calendars. Current year calendars are included if this month or less. The special value "0" (the number zero) means do not include current year calendars. For example, 8 (the number eight) means include current year calendars if today is August 31st or earlier (the 8th month or earlier).
The data.year.next specifies the minimum month to include next year calendars. Next year calendars are included if this month or greater. The special "0" (the number zero) means do not include next year calendars. For example, 7 means include next year calendars if today is July 1st or after (the 7th month or after).
Upload make-ini.txt to the same directory where make.pl is located.
Delete the *.db files in the /cgi-bin/dyse/calendars/data/ directory.
Run make.pl as you normally would.
The following are live examples of the sample template sets that are included with the DySE::Calendars script.
E.&O.E.; © Cusimano.Com Corporation; www.c3scripts.com