Installing Cake Calendar

By David Golding

After some feedback, users have been asking for a set of install instructions for Cake Calendar, so I figured I’d post it here. (To download and install the program, please visit the Cake Calendar page.)

Cake Calendar is built on the CakePHP framework meaning that not all the code is made in longhand from scratch. This actually makes life easier for developers, even though you will find more directories and files. Be sure to download the CakePHP core folder and the cakecalendar_1.0 folder.

---

Step One: Prep Folder for Uploading

You’re going to upload two folders to your server: cakecalendar_1.0 and cake (version 1.2+). Before you upload them, be sure to prep them for the install.

In the cakecalendar_1.0 > config folder, edit the database.php file. Here you will specify your MySQL settings. It’s pretty straightforward: put in the username and password. You will find another folder called sql (not the one in the config folder). The cakecalendar.sql file is the install file you will need to run in MySQL to set up your database. (If you have trouble with this, you will need to learn simple MySQL database administration methods, which I won’t go into detail here.)

Next, run a chmod 777 on the tmp folder to make it fully writeable. The cakecalendar_1.0 folder is now ready to be installed.

(You may want to make the cake_1.2xxx folder writeable as well.)

---

Step Two: Upload folders

You can rename the cakecalendar_1.0 folder to whatever you want the calendar to be called in the URL. For example, renaming the folder for my server to “davescalendar” would mean that the calendar will be accessible via http://www.davidgoldingdesign.com/davescalendar.

Upload the cakecalendar_1.0 (or renamed, if you changed it) to the server. Upload the cake libraries folder into the same directory where cakecalendar_1.0 is installed. (Usually both are housed in the public_html folder.)

That’s it! It should work fine now. If you run into errors, please consult the CakePHP installation manual, as this will actually be a Cake install error, and not a Cake Calendar one. (I will try to post common problems here as they come my way.)

---

Tips and Tricks

To access the administration area, you will need to go to the admin URL (there is no link built into the calendar incidentally, for security reasons). This will be at cakecalendar_1.0/admin. Now, you will need to create a username and password to access this area. This is kept in the MySQL database table users. You will need to create the user accounts through your MySQL database program, be it PHPMyAdmin, etc.

You can change the look and feel of the Calendar by editing only two files: admin.ctp and default.ctp. These are housed in this folder:

cakecalendar_1.0 > views > layouts

Just make sure you don’t delete one important line of code:

<?=$content_for_layout;>?

Also, the links to the CSS files and javascripts are kept in the layout using the Cake HTML helpers. You can edit these, too, but I wouldn’t recommend it unless you are familiar with Cake. Instead, just edit the webroot > css > calendar.css file, and all should still work without broken formatting.

---

Comments

2 Responses to “Installing Cake Calendar”

---

Submit Comment

Name (required)

Mail (will not be published) (required)

Website