2. Overview
Objective
Learn how to manipulate image content of ProdigyView’s built-
in content management system. Also learn how to upload an
image file directly to the cms.
Requirements
Installed version of ProdigyView with a database
Understanding of base content
Understanding of the DEFINES in ProdigyView
Estimated Time
12 minutes
www.prodigyview.com
3. Follow Along With Code
Example
1. Download a copy of the example code at
www.prodigyview.com/source.
2. Install the system in an environment you feel comfortable
testing in.
3. Proceed to examples/content/ImageContentExample.php
4. What Is Image Content?
Image content is content involves displaying an image.
Image Content in the cms supports uploading files directly
into the cms. The formats that can be used with the file
upload is png, jpeg, and gifs. Use image for web
applications such as in the example below and what ever
your imagination can expand too.
Galleries Photo Albums
Showcases Blogging
Ecommerce Products etc
www.prodigyview.com
5. Extends Base Content
Like the other content types, image content extends base
content. This means it has all the fields that base content
has in addition to the fields that describes an image.
Image Content Fields Base Content Fields
www.prodigyview.com
6. Create Image Content
Image content is relatively easy to create. In an array, passed
defined fields into PVContent::createImageContent method.
1. Define the content that will be stored as image content
3. Return content id 2. Pass the array to PVContent::createTextContent
7. Database View
Remember that the image content utilizes both the base
content and image content fields. This is accomplished
by joining two tables. Your two tables in the database
should look something like below.
Base Content Database View
Image Content Database View
8. Image Content
Fields
The previous slide only showed a
few fields that can be set when
defining image content. Here is a
complete list of fields that apply only
to the image content.
www.prodigyview.com
9. Creating An Image with File
A feature of the image content in ProdigyView is the ability
upload files while creating or updating content. For the next
example, change your sample code to
examples/content/ImageContentExampleWithFile.php
10. Image File Arguments
Similar to creating a normal image, creating an image with a file is
accomplished through setting arguments. In the example below,
we are using an image from our file system. But it can be set the
same way using PHP’s $_FILES global.
1. Name of the file 2. The location the file currently resides
3. The size of the file 4. The type of file
11. Create Image With a File
Now pass those arguments to the
PVContent::createImageWithFile() method. The content
id will be return and the image placed in your PV_IMAGE
define folder.
12. Database View
The file will be uploaded will be placed in the PV_IMAGE folder
and a reference link will be placed in the database. Your database
should look something like this:
1. Mime type 2. Image size
3. Auto generated random file name 4. Generated file name of thumbnail
www.prodigyview.com
13. Search for Image Content
Using the syntax from the PV Standard Search Query, we
can search for content related to images on using fields for
both base content and image content.
1. Search based on the passed arguments
2. Pass args into getImageContentList()
method
3. Returns an array of arrays that
contains the list of event content
14. Iterate Through The List
Next we can iterate through the list of image content to
see the data we just added.
1. Iterate through the fields base content
2. With the automatic joining of the tables, image
content fields are also returned
15. Retrieving Image Content
Image content can also be retrieved directly using the
content id. The data associated with that event id will be
returned in array.
1. Pass in the content id
2. Content is returned in an array
3. Get the values of the array by specifying
the associated index
16. Updating Image Content
That array contains the information for updating image content.
Simply change a value at an index in the array and pass it to
PVContent::updateImageContent() method. Remember the
content_id variable is required.
1. Update the owner id of the content array
2. Pass the array back to update
17. Updating With File
Referring back to
examples/content/ImageContentExampleWithFile.php, we
can also update the image file associated with the content id.
The old file will be replaced.
1. Set the name of the file 2. The current location of the file to
copy
3. The size of the file 4. The type of the file
18. Deleting Image Content
The last action to take place is deleting the image content.
To delete content, we pass the content id into
PVContent::deleteContent method.
All the content types(audio, video, event, etc) use the
PVContent::deleteContent method. Associated files
will be deleted also.
www.prodigyview.com
19. Review
1. Create image content by passing an array of arguments into
PVContent::createImageContent()
2. PVContent::createImageContent() will return the id of the
newly generated image content
3. Search for image content by using the syntax from PV
Standard Search Query and passing those arguments into
PVContent::getImageContentList()
4. Update content by passing an array of accepted fields in
PVContent::updateImageContent(). The content_id must
be present for this method to work.
5. Delete image content by passing the content_id into
PVContent::deleteContent().
www.prodigyview.com
20. API Reference
For a better understanding of image content, visit the api
by clicking on the link below.
PVContent
More Tutorials
For more tutorials, please visit:
http://www.prodigyview.com/tutorials
www.prodigyview.com