Skip to content

craigk5n/webcalendar

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
Mar 11, 2022
Jun 27, 2017

WebCalendar README

Project Home Page: https://www.k5n.us/webcalendar/ Project Owner: Craig Knudsen, craig@k5n.us
Documentation:

Developer Resources:

Installation Instructions

After unzipping your files (or transferring the files to your hosting provider, you will need to go to the web-based install script. If your files are installed in a "webcalendar" folder under your parent web server document root, you can access the script by going to:

https://yourserverhere/webcalendar/

(Obviously, put the correct server name in above.) The toplevel URL will automatically redirect to the installation wizard.

Running WebCalendar with Docker (PHP 8.1)

You can use a prebuilt WebCalendar image rather than building it yourself locally. You will need to shell into the MariaDb container to grant access. Because we also need a database, we use a local network with WebCalendar and MariaDb running that is setup with the docker-compose command.

  • Start the containers: docker-compose -f docker/docker-compose-php8.yml up
  • In order to grant the proper permissions inside of MariaDb, you will need to run a few MySQL commands. First shell into the mariadb container: docker-compose -f docker/docker-compose-php8.yml exec db /bin/sh
  • Start up the db client: /bin/mariadb -p (the password will be "Webcalendar.1" as specified in the `docker-compose-php8.yml' file. You can change it to make your dev environment more secure (before you build the containers in step above).
  • Run the following db commands:
    GRANT ALL PRIVILEGES ON *.* TO webcalendar_php8@localhost IDENTIFIED BY 'Webcalendar.1'  WITH GRANT OPTION; 
    FLUSH PRIVILEGES;
    QUIT
    
  • Start up your web browser and go to: http://localhost:8080/.
  • Follow the guided web-based setup and choose "mysqli" as the database type. Be sure to use the same MariaDb credentials specified above (Password WebCalendar.1 and Database Name webcalendar_php8.)

Setting Up a Docker Dev Environment (PHP 8.1)

You can setup a docker environment with PHP 8.1 and MariaDb with a few steps. This docker setup differs from the normal WebCalendar docker image in that the local WebCalendar files are mounted into the container so that changes to your local filesystem will also apply to the WebCalanedar files in the container.

  • Build the docker container with docker-compose -f docker/docker-compose-php8-dev.yml build
  • Start the containers with docker-compose -f docker/docker-compose-php8-dev.yml up
  • In order to grant the proper permissions inside of MariaDb, you will need to run a few MySQL commands. First shell into the mariadb container: docker-compose -f docker/docker-compose-php8-dev.yml exec db /bin/sh
  • Start up the db client: /bin/mariadb -p (the password will be "Webcalendar.1" as specified in the `docker-compose-php8-dev.yml' file. You can change it to make your dev environment more secure (before you build the containers in step above).
  • Run the following db commands:
    GRANT ALL PRIVILEGES ON *.* TO webcalendar_php8@localhost IDENTIFIED BY 'Webcalendar.1'  WITH GRANT OPTION; 
    FLUSH PRIVILEGES;
    QUIT
    
  • Start up your web browser and go to: http://localhost:8080/.
  • Follow the guided web-based setup and choose "mysqli" as the database type. Be sure to use the same MariaDb credentials specified above (Password WebCalendar.1 and Database Name webcalendar_php8.)

Setting Up a Docker Dev Environment (PHP 7.4)

You can setup a docker environment with PHP 7.4 and MariaDb with a few steps.

  • Build the docker container with docker-compose -f docker-compose-php7.yml build
  • Start the containers with docker-compose -f docker-compose-php7.yml up
  • In order to grant the proper permissions inside of MariaDb, you will need to run a few MySQL commands. First shell into the mariadb container: docker-compose exec db /bin/sh
  • Start up the db client: /bin/mariadb -p (the password will be "Webcalendar.1" as specified in the `docker-compose-php7.yml' file. You can change it to make your dev environment more secure (before you build the containers in step above).
  • Run the following db commands:
    GRANT ALL PRIVILEGES ON *.* TO webcalendar@localhost IDENTIFIED BY 'Webcalendar.1'  WITH GRANT OPTION; 
    FLUSH PRIVILEGES;
    QUIT
    
  • Start up your web browser and go to: http://localhost:8080/.
  • Follow the guided web-based setup and choose "mysqli" as the database type. Be sure to use the same MariaDb credentials specified above (Password WebCalendar.1 and Database Name webcalendar.)

About

WebCalendar is a PHP application used to maintain a calendar for a single user or an intranet group of users. It can also be configured as an event calendar.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published