Quick Reference

Images

Media files in Manifesto are uploaded to a central repository, and can have default metadata associated with them (format, output method, dimensions, caption). When using media on the site, however, we rarely embed a reference to the default Media object.

Instead, in most cases, you will be using a MediaInstance object, which is an instance of using a particular Media object in a particular context. A MediaInstance object may have a different caption, or different output dimensions or alignment than the base Media object it represents, so you can reuse the same media throughout your site, but with different captions or sizes.

Fully-instantiated Manifesto objects that support images all have an media_array property (each element is a full MediaInstance object, and the array is iterable). You may also retrieve the associated image marked as the “icon” of your content with the simple call:

$img = $obj->get_icon();

and then display it with one of the pre-built output methods:

echo $img->insert_file(); // Output standard size image in an IMG element, optionally linking to URL from $img->linkto property
echo $img->insert_thumb($url=null); // Output the thumbnail image in an IMG tag, optionally linking to $url
echo $img->insert_with_caption($variant=null) // Full-blown FIGURE tag with any size variant and FIGCAPTION if $img->caption is not empty

Bear in mind that all of these media insertion methods will also work with PDFs, documents, video files, etc. Each of them will handle the proper output method determined by the Mimetypes array and the methods in the media_output_formats.inc file.

If you prefer to handle the HTML output yourself:

$img->get_urlpath($variant=null)

will get you the full URL to your media file.

Dates

Manifesto uses its own internal Date object for convenience, and automatically converts database date and datetime formats to Manifesto Date objects when they are retrieved from the database. From that point, you simply need to figure out what format you want to be used in the output:

$d = Date::now();
echo $d->get_date($format=null);

Format string	Example output
date_short	01/30/12 or 30/01/12
date_long	January 30, 2012 or 30 January 2012
date_brief	01/30 or 30/01
extended	Sunday, 30 January 2012
nicedate	Jan 30, 2012 14:45 or 30 Jan, 2012 14:45
datetime	30 Jan 2012 2:45:13 PM
datetime_utc	30 Jan 2012 14:45:13 UTC
datetime_short	1/30 14:45 EST or 30/1 14:45 EST
time_short	2:45 PM or 14:45
dow	0-6 (Sunday-Saturday)
monthname	January
time	2:45:36 PM or 14:45:36
timewithzone	14:45:36 EST
week	13 (Week of year)
day_short	Sat
day_long	Saturday
ical_date	20120130
ical_datetime	20120130T144536
[strftime_format]	Any valid strftime() format string
date	return default date format (30 Jan 2012)