Docs – PHP Event Calendar https://phpeventcalendar.com Modern Event Calendar For Your Website. Wed, 20 Nov 2024 04:04:28 +0000 en-US hourly 1 https://wordpress.org/?v=7.0.4 System Requirements https://phpeventcalendar.com/docs/system_requirements/ Mon, 09 Jun 2014 20:34:27 +0000 http://phpeventcalendar.com/?p=370 PHP Event Calendar is a out-of-box web calendar/scheduler solution. It will run on web servers that support PHP 5.3 and higher.

  • PHP 7.0 or later
  • Apache, Tomcat, or Microsoft IIS web server
  • MySQL database (more databases support coming up!)

PHP Event Calendar is designed to support multiple database type. The current database supported is MySQL only. MS SQL Server, Oracle and PostgreSQL support will be added soon.

mysql-logo

PHP Event Calendar Supports all major web browsers:

browser_compatibility

]]>
Installation https://phpeventcalendar.com/docs/installation/ Mon, 09 Jun 2014 21:21:04 +0000 http://phpeventcalendar.com/?p=372

First of all, acquire a copy of PHP Event Calendar from the download page. Extract the zip file somewhere on your web server.

Create Database

Before start using Event Calendar on your site, create calendar database by executing pec_db_mysql.sql script in MySQL.

pec install sample db

Configuration

Once database has been created, specify database connection information in conf.php file. The database table name is “php_event_calendar“.

define('PEC_DB_HOST','localhost'); // database host name or IP
define('PEC_DB_USER','root'); // database login name
define('PEC_DB_PASS',''); // database passworld
define('PEC_DB_TYPE','mysql'); // database type
define('PEC_DB_NAME','php_event_calendar'); // database table name
define('PEC_DB_CHARSET','');

define('PEC_PATH', '/phpEventCalendar'); // URL to PHP Event Calendar folder.

PEC_PATH

PEC_PATH represents the absolute URL to the PHP Event Calendar folder on your web server.

For instance, if the URL to get to the PHP Event Calendar is https://www.yoursite.com/phpEventCalendar, or https://localhost/phpEventCalendar, the PEC_PATH should be “/phpEventCalendar“.

define('PEC_PATH', '/phpEventCalendar');

if the URL to PHP Event Calendar is https://www.yoursite.com/admin/phpEventCalendar, or https://localhost/admin/phpEventCalendar, the PEC_PATH should be “/admin/phpEventCalendar“,

define('PEC_PATH', '/admin/phpEventCalendar');

and so forth.

]]>
Start Using Your Events Calendar https://phpeventcalendar.com/docs/start/ Mon, 09 Jun 2014 22:01:54 +0000 http://phpeventcalendar.com/?p=376 During installation, PHP Events Calendar creates a login similar to the page online event calendar demo. The default login is

name: admin
password: 123456

You can change the login credential in “pec_users” table in MySQL. The password is encrypted by MD5 hash. You can generate one here.

Here’s the SQL query to insert new user into the calendar database table ‘pec_users’ with user role as “user”. You would need to simply replace with some real user data. The password is encoded in MD5. Web-based GUI users management tool will be added in future release.

INSERT INTO `pec_users`
(`access_key`, `activated`, `admin_id`, `role`, `first_name`, `last_name`, `active_calendar_id`, `company`, `username`, `password`, `email`, `timezone`, `language`, `theme`, `kbd_shortcuts`, `created_on`, `updated_on`)
VALUES
(NULL, 1, NULL, 'user', 'Joe', 'Blow', '0', 'Rand Corp', 'joeblow', md5('123456'), 'joeblow@example.com', '+6', 'English', 'default', 1, NOW(), NOW());

Note that the above default user account is an admin account who can create and modify any event. To display events read only, send your users to public calendar page in which the events can be browsed but cannot be modified.

public_calendar

Please note that users who have “admin” role can have access to all calendars of other non-admin users.

The role can only be changed in database table “pec_users”.

user role

 

]]>
Calendar Overview https://phpeventcalendar.com/docs/calendar-overview/ Mon, 09 Jun 2014 22:42:51 +0000 http://phpeventcalendar.com/?p=388 Once logged in as an admin, user will see a web calendar similar to the following. New events can be added to the calendar by clicking a date or import a Google Calendar events (see the next post).

Click below to enlarge.

calendar_overview
(click to enlarge)

]]>
Add New Calendar https://phpeventcalendar.com/docs/add-new-calendar/ Mon, 09 Jun 2014 22:54:32 +0000 http://phpeventcalendar.com/?p=391 It’s easy to add a new blank calendar or directly import a Google Calendar by click “Add Google Calendar Instead” button in New Calendar window.

Create a New Blank Calendar

Click on the plus sign “+” on the calendar list in the left sidebar to create a new blank calendar.

Create a new calendar

Click on “Create Calendar” to finish creating a new blank calendar.

Import a Google Calendar

Another way to create new calendar to import from Google Calendar which can serve as an alternative backend calendar manages system.

Google now requires both its Calendar API key and Calendar ID. As of Nov 17th 2014, Google shut down V1 and V2 of their Calendar APIs. You can no longer using the Google Calendar public URL for import.

You must first have a Google Calendar API Key:

  1. Go to the Google Developer Console and create a new project (it might take a second).
  2. Once in the project, go to APIs & auth > APIs on the sidebar.
  3. Find “Calendar API” in the list and turn it ON.
  4. On the sidebar, click APIs & auth > Credentials.
  5. In the “Public API access” section, click “Create new Key”.
  6. Choose “Browser key”.
  7. If you know what domains will host your calendar, enter them into the box. Otherwise, leave it blank to allow any hosts. You can always change it later.
  8. Your new API key will appear in a few seconds.
  9. Copy the key for later use.

Make your Google Calendar public:

  1. In the Google Calendar interface, locate the “My calendars” area on the left.
  2. Hover over the calendar you need and click the downward arrow.
  3. A menu will appear. Click “Share this Calendar”.
  4. Check “Make this calendar public”.
  5. Make sure “Share only my free/busy information” is unchecked.
  6. Click “Save”.

Obtain your Google Calendar’s ID:

  1. In the Google Calendar interface, locate the “My calendars” area on the left.
  2. Hover over the calendar you need and click the downward arrow.
  3. A menu will appear. Click “Calendar settings”.
  4. In the “Calendar Address” section of the screen, you will see your Calendar ID. It will look something “sdfalskjfasfjsasdf12323asdf@group.calendar.google.com”.

Final Step: Save both Google Calendar API Key and ID in Our Event Calendar

Now, you should have both Google Calendar ID as well as its API Key:

  1. Enter the Calendar ID in New Calendargoogle-calendar-import-v3
  2. Enter the API Key saved earlier in the Calendar Settings.google-calendar-import-v3-settings

TL;DR? Watch screencast! Google Calendar Import

]]>
Manage Existing Calendars https://phpeventcalendar.com/docs/manage-existing-event-calendars/ Tue, 10 Jun 2014 09:06:07 +0000 https://phpeventcalendar.com/?p=691 Click on the gear icon to open the Manage Calendar window:

manage_calendar_icon

The Manage Calendar Window has the following options:

  • Export – export the selected calendar in .ical format (more on iCalendar format).
  • Make Public/Private – When set to private, the calendar is not publicly accessible.
  • Delete (Calendar) – Delete a calendar. Warning: all its events will be removed permanently!
  • Edit (Calendar) – Edit calendar title, description, and color etc.

Note that the globe icon links to a public URL for that specific calendar.

Manage_Calendar

]]>
Calendar Event (New/Edit) Window https://phpeventcalendar.com/docs/calendar-event-window/ Wed, 11 Jun 2014 23:00:50 +0000 http://phpeventcalendar.com/?p=393 In event window, an user can specify event basic information, Title, Start and End Date and Time, repeating event section and additional event information, plus email reminders.

The event window comprises the followings:

  • Basic Event Information
    • Title
    • Start & End Date Time
  • Standard Settings:
    • Repeating Events
    • Description
    • Organizer
    • Resource
    • Background Color
    • Event Image
    • Privacy
  • Venue
  • Reminder
  • More to come…

Note that some features are only available in paid version such as repeating events, multiple calendars, and reminder.

pec-event-window

]]>
Create a Basic Event https://phpeventcalendar.com/docs/create-basic-event/ Mon, 26 Jan 2015 12:15:36 +0000 https://phpeventcalendar.com/?p=702 The first thing in Edit Event Window is the basic event section. To set up a basic event, the only information needed are a Title, Start & End date and time. When the All Day checkbox is selected in Standard Settings, the End date and time are not needed.

basic_event_info

]]>
Repeating Events https://phpeventcalendar.com/docs/repeating-events/ Mon, 26 Jan 2015 13:00:36 +0000 https://phpeventcalendar.com/?p=699 PHP Event Calendar supports repeating events. To set recurring events, in Event Edit Window (shown in previous post), check “Repeat” checkbox in Standard Settings section. Common event intervals are readily available to choose from.

Users can also specify Start date and Ending Condition. The repeat patterns are designed similar to Google Calendar has.

event-repeat

]]>
Additional Event Information https://phpeventcalendar.com/docs/enter-additional-event-information/ Mon, 26 Jan 2015 13:47:21 +0000 https://phpeventcalendar.com/?p=708 Enter additional event information in the Standard Settings section.

  • Organizer
    • Click “Add Organizer” to add one first if it’s not already existed in the dropdown.
  • Resource
    • Click “Add Resource” to add a resource first
  • Calendar
    • Select an existing calendar from the dropdown
  • Privacy

You can also update an image for the event and choose whether to display the image thumbnail in month view only.

event_standard_settings

]]>