|
You can click any of the
dates on either Calendar to view the events scheduled that day, or see a bullet-list of
all the (currently selected) month's events displayed under the large
Calendar. By setting a few configuration options in one file, you can
completely customize the ASP Events Calendar to suit your needs.
Check out the complete feature-list
below, or view the demo.
NEW VERSION AVAILABLE! I've just added a Deluxe
version of the Calendar to my site, which includes support for all
International Date-Formats and Languages, Event-Approval features, and much
more! I'll be adding a site and Admin demo shortly
- but in the meantime, if you're interested in these extra features, please
click here for more details on the Deluxe version.
By the way, by just changing one of the configuration settings
(changing the words "Events Calendar" to "My
Journal" or whatever),
this application can also be used as a "blogger" (web-log) or an
online, daily journal. I'm pretty much giving away the store by selling this
thing for this price, given the fact that similar applications can cost
quite a bit more, and those third-party service providers
(blogger hosts) can charge you about the same amount per month...
When you're ready to purchase this product, just use the buttons
provided to add this item to my PayPal Shopping Cart, follow
the instructions provided, and then we'll send the item(s) you've
ordered by e-mail! (Note: For only $17, you get the
complete application (along with free upgrades), which you can
configure and "plug-in" within minutes -- saving you many
times this amount in development costs.)
Note: Click here for
a print-version of this documentation.
Calendar & Admin DEMO:
- Click here to view the ASP Events
Calendar DEMO
- Note: I've turned on the switch (already included in the settings
file), to allow the general public to add Events to this Calendar.
- Also: I just
unzipped the files a calendar folder, changed three lines in the
settings file, made sure the database was read/writable, and -
viola'! Except for customizing the header and footer (for
which spaces are already provided in the code), and configuring a
few lines in the settings file (as per the instructions), the
application you're about to view is unchanged from the
actual source-code that you can purchase and download today!
- Calendar ADMIN Tools
- Login using: "admin" and "password".
- Note: I've set-up
the demo so you can add Events, but not delete anything, edit any existing Events,
change the login information, or view the database connection
strings. This is simply so I don't have to constantly monitor the
Calendar making sure other visitors are able to use it. The links and
Admin options are still viewable though, so you can see where they are
and how they'd work.
ASP Events Calendar Features and Documentation: (below)
[ ASP Events Calendar Features ]
- Online Administration:
- Update the Calendar online, from anywhere, using the Administration
Web page provided.
- With the Administrative tools, you can (1.) Add/Edit/Delete Events,
(2.) Delete all Events at once (scary, but sometimes necessary) or
(3.) Change the Calendar's Admin Username/Password.
- View Calendar alone, or include on other
pages:
- You can insert or include the small Calendar (shown at top-right),
complete with clickable links, on any page on your site. Or view the large Calendar
(page) directly, where every date links to the
complete list of events scheduled that day.
- Many Public/Visitor options:
- Visitors can view any past or future months and years using the clickable arrows
on each Calendar page.
- The public can add Events to the Calendar (if you've set that
switch to be turned on), and the Calendar automatically creates
clickable links around any URLs or e-mail addresses in the entered
text.
- Display and view an unlimited number of Events on every page.
- Fully configurable with several
database/back-end
options:
- Display or hide a bullet-list of the entire month's events (which
appears under the Calendar by default).
- Set Public or Admin-ONLY privileges. You can allow the general
public to add Events to the Calendar, or not. (The default setting
allows only the primary Administrator to Add events).
- Once you've logged-in to the Admin area, you can Edit or Delete
any event you wish.
- You can control the font-settings and color-scheme for the entire
application from one single file ("styles.asp").
- You can include your own site headers, page-top-tools, configuration
files, left-nav and footers on every page. Placeholders for several
"server-side-includes" have already been provided
(commented-out by default), so that the Events Calendar can be
integrated - seamlessly - with the rest of your site, or you can just
replace the existing (fully commented) header, sidenav and footer
HTML/code with your own.
- Ten (10) background color options are already included (11, if you
count white) and can be set with just one switch.
- When adding Events, you don't need to worry about writing any HTML
around links or e-mail addresses. The Calendar automatically creates
clickable links for you whenever it displays an Event!
- Choose one of several available database and connection options,
using the included Access or Access2000 (default) files (with or
without DSN), SQL, Jet OLEDB and DSN. Note: I've also just
added a verification page (with version 2.7) so you can easily
confirm and adjust your database configuration and settings after
logging-in to the Admin area.
- Ready-to-go, in minutes!
- The text and details on every page, the overall design,
color-scheme, page-layout and graphics are all completely
"production-ready". You don't have to change anything
(except to put your site name in the settings/configuration file), and
the ASP Events Calendar is ready-to-go, and will still look like it
was custom built just for you and your Web site!
[ System Requirements & Tools ]
- A Web site host that supports Active Server
Pages
- To view the web pages, either on your local machine or at your Web
site, you'll need to be running a Web server which supports ASP
pages (files with *.asp extensions). Most later versions of Windows include the "Personal Web
Server (PWS)" which supports ASP, and your site host should
clearly indicate which systems and platforms they support. As long
as they mention "Microsoft", "IIS", "NT
Server", "ASP", "Active Server Pages", or
"Windows 2000" you should be fine.
- A text-editor (Notepad will work fine)
- To edit these files, you only need a text-editor to change the
settings/variables in one file (settings.asp). It's hard to predict
what might happen if you use a visual webpage editor (like
FrontPage, GoLive or DreamWeaver) to change any of these files.
Those editors tend to re-write code and break stuff. Also, if you're
not familiar with ASP/VBscript, and do not have a more advanced text
editor (which provides visual indicators and color-coding when
viewing a file), just be sure to leave commented text (beginning
with (') apostrophes) unchanged, and only change variables
in-between quotes. For example:
theSiteName = "Your
Site Name" '
change Your Site Name
- Host support for Microsoft Access, Access2000 or SQL databases
- By default, this application uses an Access2000 database file, but
also includes a standard Access file which you can use if your host
does not yet support Access2000.
- ASP Events Calendar is also SQL-ready. If you're familiar with SQL
Server, and would prefer using the SQL database (instead of Access),
the connection-strings are already available and you just need to
(1.) update the variables in the settings/configuration file, and
(2.) use Access 2000's "Upsizing Wizard" or other
remote database administration tools to copy the database structure
and data to your SQL db.
- You don't need an ODBC or DSN connection!
[ Installing ASP Events Calendar ]
- Unzip aspEventsCal_(version).zip into a folder that will
be used/copied on your site (these files are currently configured to
work in a "/calendar/" sub-folder).
- Open the included settings.asp file with a
text-editor and make sure to configure the variables as needed. This
file controls all the application functions for the ASP Events
Calendar.
- Use a text editor to make any necessary updates to styles.asp
(this file controls the look-and-feel of the application). If you're
familiar with stylesheets, you can alternately just add the calendar
styles to your own stylesheets and then either remove the
reference/include to the above file in all the other files, or just
edit styles.asp to completely remove all of the internal contents of
the file, save it, and then leave the file in-place.
- Make sure the database file has
Read/Write/Script(/Execute) permissions (this will happen
automatically on your local machine, but you'll probably need to
request this from your site host (ISP) if they don't already provide
you administrative tools to do so yourself. See details below.
- Open your Web browser and view the site/folder where the ASP Events
Calendar has been placed (ex., http://localhost/calendar).
"index.asp" is the web page people use to view the
large Calendar, and "admin.asp" is where you'd log-in
to add/edit/delete events, or change the username/password for this
application.
Note: The
default Username and Password is "admin" and "password"
- IMPORTANT: If
you don't change the default Admin username/password, then anyone else
who has downloaded these scripts could easily figure out how to access
your calendar... so change them!!!
- To include the small Calendar, or have it
displayed on any other page on your site, you'll need to use a
standard server-side-include (a bit of HTML that tells one page to
load the contents of another). Basically, edit the page(s) where you
want to small Calendar to be displayed, and insert this code:
<!--#include
virtual="/calendar/calendar_include.asp"-->
Note: "/calendar/"
is the folder name where you've placed the Events Calendar
- Lastly, every page already includes placeholders so you can
load your own site headers and footers, page-tools and other
navigation. These placeholders are "server-side-includes"
(an HTML comment that tells one page to load the contents of another)
which have already been provided, so that the Events Calendar can be integrated - seamlessly - with the rest of your site.
All you need to do is add your content to any of the (currently empty)
files below, and the ASP Events Calendar appearance and layout will
reflect the changes when you view the web page(s).
header.asp (include your header, logo and any other style
specifications here)
leftnav.asp (already contains example HTML code, which you'd
need to un-comment to view)
pagetoolstop.asp (for any navigation or page-top code)
pagetoolsbottom.asp (for any navigation or page-bottom code)
footer.asp (for your navigation, footer links, copyright
statement, etc.)
[ Troubleshooting ]
Virtually all problems encountered during the set-up,
configuration and usage of the ASP Events Calendar can be traced to the
following issues:
- The database file (calendar2000.mdb) must have its
permissions set to Read-Write (rw-). Visitors should also have access
to "write" to the database in order for the scripts to
function.
Note: Many site
hosts provide administrative tools so you can set permissions on files
yourself. Otherwise, contact your site host and request the above.
- Open settings.asp with a text-editor, and make sure you have entered the correct
calendar folder, database filename, database connection
information, etc.
- If you have changed this code and are running more than one
database-dependent application from these pages, there may be
conflicting variables (which would result in a "variable
redefined" error message).
- Visual HTML editors (like FrontPage, DreamWeaver or GoLive) have a
nasty tendency of re-writing HTML and breaking the code that
makes these types of applications function correctly. If you
absolutely must use one to edit the look and layout of these pages, do
so at your own risk... BUT it is absolutely essential you only use a
text editor, or Notepad when working with the primary configuration
file, settings.asp.
- Here's another tip: Chances
are you're using Internet Explorer - which means you probably aren't
seeing the actual messages from your server if you're having troubles.
Just go to your "Tools : Internet Options" menu, and select
the "Advanced" tab. Scroll down the Settings list a bit, uncheck
the "Show friendly HTTP error messages" box, and then
click "OK". The next time you start your browser, and
encounter any browser or server error messages, you'll see the actual
server error codes (which you can use to figure out the problem and
solutions), as opposed to the nice browser messages which don't tell
you anything.
[ Other Notes ]
Important: There
are two images used to control the layout and appearance of the Events
Tabs and large Calendar, which both use a particular color that is
supposed to match the background of the page body where the item is
displayed.
By setting the variable "PageBGColor" in settings.asp,
you are not only setting the page background color, but you're also
telling the application which colored set of graphics to load. In order to
use a CUSTOM color (which is NOT one of the 10 options already provided),
just review the details below and follow the instructions.
- legend_<%=PageBGColor%>.gif
is an image used to provide a nice background color for the
fieldsets/legends (Events tabs). I would have used a style/HTML color,
but fieldsets/legends are limited. The color of the top,
non-transparent portion of this background image needs to match the
background color of, in this case, the default page body background
color (and "PageBGColor" variable) F8F8F1.
You can also just remove these two lines from the "fieldset"
style in styles.asp and not worry about working with these
legend images at all:
background-color: #F4F3E0;
background-image: url('<%=calFolder%>legend_<%=PageBGColor%>.gif');
- color_spacer_<%=PageBGColor%>.gif
is an image used to create the floating, drop-shadow effect of the
Calendar against the page background. The color of this image (and the
filename) also needs to match the page body background color.
For CUSTOM colors: Just
make a copy of any existing "legend...gif" and
"color_spacer...gif", change the color (leaving any existing
transparency), and make sure the filenames include the HEX color you used.
For example, if you want a red page background (HEX color
"FF0000"), you'd need to create the two images using the
filenames "legend_FF0000.gif" and
"color_spacer_FF0000.gif", and then set the variable
"PageBGColor" (in settings.asp) to "FF0000".
Please note, the only support provided for this application is
included in this file. No e-mail or other online support is available.
|