Skip to content
objectivehtml edited this page Dec 14, 2014 · 2 revisions

What is a Parcel?

A parcel is a way for users to schedule content to be sent when events in Craft are triggered. Parcels can be triggered with any event in Craft, even for third-party applications. Parcels have 3 different components: the parcel type, the parcel schedule, and the service used to send the parcel. Parcels can be send at the time their events are triggered, or parcels can post-date content to be sent in the future.

What is a Parcel Type?

A parcel type fundamentally changes each parcel but its basic job is to determine if a parcel should sent. Each parcel type can provide unique parsing routines, events, and custom validation rules to determine if parcels should be sent. A parcel type can have its own unique settings fields and UI. Developers can create their own parcel types to do custom things that fall outside the scope of what is inherently provided by Postmaster.

What is a Parcel Schedule?

A parcel schedule is what is used to determine when a parcel should send. If the parcel type's job is to determine if the parcel should send, then parcel schedule determines when it should be sent (like now or in the future). Like parcel types, parcel schedules have their own unique settings and UI's. Developers can create their own parcel schedules for more advanced scheduling.