Download the PHP package thepublicgood/timewarp without Composer

On this page you can find all versions of the php package thepublicgood/timewarp. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package timewarp

Timewarp

Build Status Codacy Badge GitHub License GitHub Release

Timewarp is simple library for dealing with iCalendar objects. The library attempts to adhere to RFC 5545 and 5546.

There's a lot of features and requirements missing and I'll work on documentation as time allows. It might not be as up-to-date as it should be until a version 1.0 is complete, so I cannot make any promises as to the quality of the documentation. However I use Timewarp myself in a number of projects, so it does (and will) receive updates.


Installation

Timewarp can be installed with Composer:

Or update your composer.json file with do a composer update:

Usage

An iCalendar object is generally composed of a number of properties and calender components. A calendar object MUST contain at least one calendar component, and will often not contain more than one, although entirely possible.

Timewarp calendars can be created in one of two ways. Either create the calendar object first and add components to it, or create a calendar component and wrap it in a calendar object. You might find the later approach to be a little more semantic when working with a single component.

Calendar Objects

Create a new calendar object by instantiating the Calendar class:

Add components to the calendar by calling the addComponent method and passing in an instance of a Timewarp component.

Calendar Properties

All calendars MUST include at least two properties. The first is a Version property. You won't need to add a Version property yourself as Timewarp will add it when you create a new Calendar object.

Product Identifier

You are required to add the product identifier to the calendar.

The product ID is meant to specify the product that created the iCalendar object, and MUST be globally unique. A common approach to product IDs, take a look at Formal Public Identifiers (ISO.9070.1991).

Method

You can specify a method on the calendar. The iCalendar spec does not define any values for the METHOD property, so whatever you pass here should have some meaning to your application.

No other properties can be added directly to a calendar object and attempting to do so will result in a FailedConformanceTestException.

Creating events

You can create a new event component by instantiating the Components\Event class:

Properties can be added to the component through the addProperty method. The appProperty method returns the current object so it can be chained. The method accepts a single Property object which is any object that inherits from the Property class. Timewarp provides most of the standard properties in the Timewarp\Properties namespace.

Add the event component to an existing calendar object:

...or create a new calendar from the component:

A place to start...

Component Properties

Timewarp provides a class to represent each iCalender property. So the DTSTART property. so the DTSTART property is represented by the Start class, and the DURATION property is represented by the Duration class.

Many of the iCalendar properties can be added to any of the different components, although a few properties are component specific, and Timwarp will thow a FailedConformanceTestException if you try to add a property to component that doesn't support it.

Attachment Property

An attachment is a representation of a document on a component. Attachments can be added to Event, Todo, Journal and Alarm components.

Unlike the other property classes, Timewarp provides two separate classes to represent attachments. The UriAttachment and BinaryAttachment properties.

BinaryAttachment will automatically determine the mime-type if a file is passed in. you can, however, pass in your own base64 encoded string and include the mime-type as the second parameter.

Categories Property

A category is a simple text string which can be used to categorize iCalendar components. The RFC 5545 document states that "categories are useful in searching for calendar components of a particular type".

The Categories property allow for multiple values, so you can pass in an array of values:

Classification Property

The classification property forms part of the general security within a calendar application. It allows the application to specify the accessability others have to the information in the object.

Timewarp allows one of three values to be set as the classification. PUBLIC, PRIVATE or CONFIDENTIAL. Timewarp provides these values as class constants as well:

Comment Property

A simple comment that can be included in the calendar object and provides information to the calendar user.

Calendar object lines should never exceed 75 octets. Comments will automatically be broken up across multiple lines as needed.

Description Property

Geographic Property

Location Property

Percent Complete Property

Priority Property

Resources Property

Status Property

Summary Property

Start Date

Represents the starting date and time of the component. This property can be added to Event, Todo and FreeBusy components.

The Start property accepts a standard PHP DateTime object:

End Date

The End property is exactly the same as the Start property, but represents when a component is supposed to end.


All versions of timewarp with dependencies

PHP Build Version
Package Version
Requires php Version ^7.1.8
nesbot/carbon Version ^2.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package thepublicgood/timewarp contains the following files

Loading the files please wait ....