comicpress-core/docs/en_US/media-uploader.html

<h1>Uploading and Managing Comic Files</h1>

<h2>Comic Image Types</h2>

<p>
	<img src="../images/comic-image-types.png" alt="Comic Image Types" class="alignright" />

	On webcomic websites, the comic image or images for a post typically have additional images associated to them &mdash; images for the archive pages, for nagivation, and for RSS feeds are common.

	These images usually have set widths and/or heights so that they fit in with the layout of each page.

	You can set these dimensions, as well as other important properties, on the <em>ComicPress</em> theme options page under <strong>Comic Image Types.</strong>

	In a default <em>ComicPress Core</em> install, the following properies of each image are modifyable:
</p>

<ul>
	<li><strong>Name:</strong> The name of the image type when it's referred to within WordPress.</li>
	<li><strong>Short name:</strong> When using the <code>EM()</code> tag, the string used to access that particular image of a comic.</li>
	<li><strong>Default image type:</strong> If you don't provide a string to the first parameter of <code>EM()</code>, this is the image to show. There must always be a default image.</li>
	<li><strong>Dimensions:</strong> The width and/or height to set this image to when shown on screen. If set before uploading images, the standard WordPress thumbnail generation mechanism will automatically generate images of these sizes for you.</li>
</ul>

<p>
	Other backends &mdash; ways of accessing different data sources beyond post attachments &mdash; may provide additional options in the future.
</p>

<p>
	You can add an infinite number of image types to your site, but you need at least one to be able to use ComicPress, even if you never embed any images.
</p>

<br style="clear: both" />

<h2>WordPress Media Uploader Integration</h2>

<p>
	<img src="../images/comicpress-media-uploader.png" alt="ComicPress Media Uploader" class="alignright" />

	<em>ComicPress Core</em>'s standard method of storing comic images uses the <strong>Media Uploader</strong> under <em>Edit Post</em>.
	This is the way you normally upload images for inserting into your posts, except now, you have an additional option to enable so that
	ComicPress knows to treat an uploaded image as a comic image.
</p>

<p>
	After uploading an image, check <strong>Let ComicPress treat this image as a comic media file</strong>. This will enable ComicPress management of the file.
</p>

<p>
	Uploaded media needs to be attached to a post so that ComicPress can work with it. You'll see all of the attached images under the <strong>Gallery</strong> tab.
	If you want to use an image in your Media Library that isn't attached to the post, find the image in your Library, enable the option <strong>Change Parent?</strong>,
	and save the changes. A file can only be attached to one image at a time.
</p>

<p>
	<code>&lt;img title&gt;</code> hovertext, a common way to add an additional punchline or comment to a comic, can be added on the <strong>Caption</strong> line.
	If not empty, it will automatically be inserted in the correct way into the image tag.
</p>

<p>
	When done, click <strong>Save changes</strong> rather than <em>Insert into Post</em>.
	<strong>Save changes</strong> will not close the popup window, so you can upload multiple images in one session.
</p>

<br style="clear: both" />

<h2>Sorting and Attaching Comic Images</h2>

<p>
	<img src="../images/comic-image-sorter.png" alt="Comic Image Sorter" class="alignright" />

	Once images are attached to a post, you can arrange them and associate sub-image types (such as RSS and Archive images) to their parent image.
	The order in which images are sorted determines how they are returned by the <code>M()</code> function, and attaching new sub-images to a parent
	image causes that attached image to replace the original in calls to <code>EM()</code>.
</p>

<p>
	To make them easier you see, you can adjust the image thumbnail size using the zoom slider on the left.
</p>

<p>
	If you attach new images using the <em>Media Uploader</em>, click the <em>Refresh</em> button to reload the ordering. Any changes not saved via <em>Update post</em> will be lost.
</p>

<p>
	The options shown are with the post attachment backend. Different backends may offer additional options from the ones presented here.
</p>

<br style="clear: both" />