Photo App guide/Specification

Myphotogenie is a service that allows estate agents, primarily, to upload images of properties for image manipulation, and also the creation of property floorplans.

This guide will describe in detail the user process for the Myphotogenie photo app, and the backend functionality, to include these steps:

Summary.

 User upload of images and/or video and selection of modifications in modification selection screen  – new project creation
 Payment process (Either by Paypal or by User Wallet which users can ‘top up’ with credits
 New project shows on the User’s dashboard, the mod team’s dashboards and the Admin project page.
 Images downloaded by the mod teams from their dashboards
 Upload of modified images back to mod team dashboards
 Partially completed projects stored in ‘Holding area’; until project is complete
 Completed project becomes available for download in the ‘User Dashboard’ as in Zip format
 User dashboard includes photo/text notes upload interface in case of requirement for revisions
 Project reopened and images uploaded the correct mod team dashboard, modified, then uploaded back to dashboard
 Completed project again becomes available for download in the ‘User Dashboard’ in Zip format

Additional functionality

Certain user roles are awarded different levels of bonus credits when topping up their User Wallet.

All projects are deleted from the system after 30 days to save server space but a text record remains in the User Dashboard

Floorplans, and ‘Standard’ images, Viedos and Staging/Re-staging are sent to different Mod team dashboards.

Desired functionality

A monthly statement of user activity on User Dashboard – scope to be determined.

PART 1 – The user
User project creation flow
User Wallet top up
User Dashboard

1. User project creation flow

User project creation flow – Step 1.  Image and Video upload interface

User uploads their images and/or video.

To include:

Title area to create Project name
Click on dropzone to select images from local machine or drag images into dropzone.
Image shows Upload progress bar and then confirmation of successful upload, image file name, and size.
‘Add funds to account’ button (links to to ‘Top up’ page where users can add credits to their User Wallet
‘Select modifications’ button to move to Step 2

Image upload interface

Image upload interface with images uploaded

User project creation flow – Step 2.  Image Modification Selection interface

Left column of Mod selection table is populated with thumbnails of the uploaded images.

Videos are seperated out and shown

User chooses the modifications for each image.

Screen shows real-time cost in the bottom right corner, cost total includes any discounts for the user role.

Open the concertina sections for details on each modification

1 Basic Edit & Blue Sky

Simple on/off selector

Cost:  £0.95

2 Day to Dusk

On/off selector

When selected, link appears (see screenshot 1)
When link is clicked, popup window opens offering three images to choose from for the day to duck background (see screenshot 2)
When image has been selected, thumbnail shows in the selection table  (see screenshot 3)

Cost: £5.95

Note:  If this option is chosen, it should not be possible to progress past the modification selection screen without choosing an image.

Screenshot 1

When selected, link appears for image choice, cannot progress beyond this screen without choosing image

Screenshot 2

On click, popup window offers three images  background choices

Screenshot 3

Thumbnail of chosen background image shows

3 Day to night

On/off selector

When selected, link appears (see screenshot 1)
When link is clicked, popup window opens offering three images to choose from for the day to duck background (see screenshot 2)
When image has been selected, thumbnail shows in the selection table  (see screenshot 3)

Cost: £5.95

Note:  If this option is chosen, it should not be possible to progress past the modification selection screen without choosing an image.

Screenshot 1

When selected, link appears for image choice, cannot progress beyond this screen without choosing image

Screenshot 2

On click, popup window offers three images  background choices

Screenshot 3

Thumbnail of chosen background image shows

4 Floor Plans

On/Off selector

On activation, offers a dropdown menu with the various types of floorplans available (Screenshot 1), prices below:
Also, causes the appearance of an image upload dropzone to allow users to upload their own template to be used for the Floor plan.  (Screenshot 2)
If the user has previously uploaded a Floorplan template(s) those images should stored on that user’s account and used to pre-populate that dropzone for selection.  (Screenshot 3)

Cost: 

3D (Above 3000 sq/ft)  £11.95

3D (Below 3000 sq/ft)  £8.95

Bespoke (Above 3000 sq/ft) £9.95

Bespoke (Below 3000 sq/ft) £6.95

Black and white (Above 3000 sq/ft) £8.95

Black and white (Below 3000 sq/ft) £5.95

Colour (Above 3000 sq/ft) £9.95

Colour (Below 3000 sq/ft) £6.95

Note:  If this option is chosen, it should not be possible to progress past the modification selection screen without choosing a Floorplan type and a template from the dropzone below the modification selection table.  Also, this option cannot be chosen if any other options has been chosen

Screenshot 1.  Floorplan type dropdown menu

Screenshot 2.  Floorplan template upload dropzone under the modification selection table

Screenshot 3.  Floorplan template upload dropzone prepopulated with stored template

5 Green Grass

Simple On/Off selector

Note:  Disables Basic Edit & Blue skies

6 Display

Display images are two images side by side, so the image selected needs to be paired with another image that has been uploaded.  (Screenshot 1)

This is achieved by clicking and dragging one of the other images that has been uploaded onto the text box shown in screenshot 1.  Doing this removes the second image from the main list of images.

A thumbnail of the chosen image shows (Screenshot 2)

Example Display image

Screenshot 1

Selecting display causes the text box/dropzone to appear

Screenshot 2

The image dragged from the left column appears in the dropzone and is removed from the left column

7 Object removal

On/Off selector –  activates a pop-up

Pop-up requires the user to describe the object(s) that need removing uising the text fields.

Hitting Return causes a new text box to appear, there is no limit to the number of text boxes.

Cost:

£3.50 per object (i.e. per text line)

8 Slideshow

On/Off Selector

Slideshow requires an address, selecting this option opens a text box.

Cost: £9.95

9 Virtual board

Simple On/Off selector

Cost: £6.90

10 Virtual Staging & Re-staging

On/Off selector – activates a pop-up

Selecting this option opens a pop-up where the user choooses between tabs for Virtual staging or Virtual Re-staging.  User cannot select both.

Text box allows input of User instructions for the staging effect

Cost: £39.95

Note:  If this option is selected, the user cannot progress from the modification screen without entering a room description.

11 Renovations

On/Off selector – activates a pop-up

Selecting this option opens a pop-up , text box allows input of User instructions for the Renovations effect

Cost: (TBC)

12 Winter wonderland

On/off selector

User chooses to add winter wonderland effects to an image.

Cannot be chosen if Basic edit, green grass, day to dusk or day to night edits have been selected.

13 Video upload area

Any videos uploaded on the initial file uploads screen need to be shown here as a thumbnail that can be deleted which would delete that file from the upload.

There should also be an upload function to allow users to add to this section, and the files should be click and draggable so that the user can put them in the correct order to be spliced together.

The file name and the order of the video files is the information that needs to be passed to the mod team for splicing.

To progress to the next step, the user must have selected at least one modification per image.

User project creation flow – Step 3.  Order confirmation

The user is asked to confirm their order in the standard Woocommerce progression.

User project creation flow –  Step 4.  Payment

User has a choice of paying via Paypal or from credits in their User Wallet

2. USER WALLET TOP UPS

The ‘Top up your account’ button allows users to visit the ‘Top up’ page and add credits to their User Wallet.

Top-ups offer a bonus of from £1 to 25% depending on the amount added to the user account.

*NOTE It would be useful for the admin to have an easy way to give users discounts or extra credits both manually, and as a type of account

The Top up button

The top-up credit options

3. USER DASHBOARD

User Dashboard

Accessed from the ‘My account’ link in the top bar navigation

The User dashboard is where the user downloads their completed projects, and requests revisions if required.

Note:  Projects are only retained on the site for 30 days, after that they are deleted to save server space, but past projects details can still be viewed in the user dashboard

The User Dashboard

3. USER DASHBOARD – Requesting revisions

User Dashboard – requesting revisions

In the ‘MY ORDERS’ section of the User dashboard, all live projects for that specific user should show, along with a button called ‘Need revision?’

Selecting that opens an image/note upload interface that allows the user to write notes for specific images and upload new images and/or image instructions/templates

Submitting a revision request re-opens the project in the project page and the new files are uploaded to Dropbox into the original project folder which is renamed ‘#12346-revision’ so that the mod team knows a revision is required.

When the mod team has done the revisions the images are uploaded back to the ‘Delivery’ folder which is renamed ‘-finished’ as normal.  Then the process completes as normal with the images being uploaded back to Myphotogenie.

The User Dashboard – Revision request popup 

PART 2, THE ADMIN BACK END
Project page – project status and details

Summary

Once a user has successfully uploaded images, chosen modifications and created a new project, the project shows on the ‘Project page’ as pending.  a Cron job runs every 15 minutes to identify new projects.  Any new projects (marked ‘Pending’) that are found are uploaded to Dropbox.

Projects are downloaded from Dropbox by the mod team, modified, and uploaded back to Dropbox.

A Cron job runs every 30 mins to find completed projects on Dropbox and any that are found are uploaded back to Myphotogenie and become available in the User Dashboard for download as a zip folder.

1. Project page

The user projects page is accessed through the ‘Projects’ link in the WordPress admin dashboard

The project page shows all projects created by users.  If the project is not complete it shows as ‘Pending’ and a timer, highlighted in green shows the time since the project was created.  If the time since created passes 24 hours the timer has a red background to show a ‘Late’ project.  The timer finishes the count when the project is closed.

Projects are assigned standard WordPress ‘post’ numbers. (Note, the post number must match the folder number created on Dropbox – covered in the Dropbox section of this guide)

Project details page

Opening the project shows you the images uploaded to the project in the left column, the images that have been uploaded back to Myphotogenie in the right column, and the modifications requested.

2. Upload to, and download from Dropbox

Summary

New projects are uploaded to Dropbox and a new folder is created on Dropbox with the subfolders and files seen in the screenshots below.

Mod team downloads the images files, modifies them, and then uploads them to the ‘Delivery’ folder.

Modified image files are uploaded back to Myphotogenie

Note:  There are two Dropbox accounts, one for Floorplans, and one for ‘standard’ images, i.e. everything that isn’t a floorplan.

Project upload to Dropbox

New projects are uploaded to Dropbox and a folder created on Dropbox with the same project number.

PROJECT FOLDER, INTERNAL FOLDERS STRUCTURE

Within the Dropbox folder for each new project is;

 README.txt – file with client-specific instructions  (Screenshot 1)
project.txt – file with the requested modifications (Screenshot 2)
All the uploaded images (Screenshot 3)
A ‘samples’ folder that contains an example image of each type of modification requested in the project  (Screenshot 4)
A ‘Delivery’ folder  – this is where the mod team upload the modified images to on completion  (Screenshot 3)

Screenshot 1. README.txt

Client specific instructions

Screenshot 2. project.txt

Contains all image modification requests

Screenshot 3. Uploaded images

Screenshot 4. Inside the Samples folder

Showing sample images of each modification type requested in the project

DROPBOX PROCESS

Mod team downloads files from the top-level project folder, does the modifications described in the project.txt file.
Mod team then uploads the modified images back into the ‘Delivery’ folder (Screenshot 5 below) and changes the top-level folder name to include ‘-finished’.
The Cron job identifies any newly finished projects and uploads them back to Myphotoegnie.

Screenshot 5. Inside the Delivery folder

Mod team uploads modified images to here

Dropbox – requesting revisions

Submitting a revision request re-opens the project in the project page and the new files are uploaded to Dropbox into the original project folder where ‘-revision’ is appended to the project number folder name so that the mod team knows a revision is required.

When the mod team has done the revisions the images are uploaded back to the ‘Delivery’ folder which is renamed ‘-finished’ as normal.  Then the process completes as normal with the images being uploaded back to Myphotogenie.

Revision request – folder renamed on Dropbox