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.

  1.  User upload of images and selection of modifications in modification selection screen  – new project creation
  2. Payment process (Either by Paypal or by User Wallet which users can ‘top up’ with credits
  3. Transfer of new project to dropbox for download by the modification team in India
  4. Upload of modified images back to Myphotogenie from Dropbox
  5. Completed project becomes available for download in the ‘User Dashboard’ as in Zip format
  6. User dashboard includes photo/text notes upload interface in case of requirement for revisions
  7. Project reopened and images uploaded to Dropbox  – upload back to Myphotogenie
  8. Completed project again becomes available for download in the ‘User Dashboard’ as 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, are sent to two different Dropbox accounts.  If a Project contains both, they must be separated and sent to the correct Dropbox acocunt.

(As much as possible, system uses native WordPress and Woocommerce functionality)

Desired functionality

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

PART 1 – The user

  1. User project creation flow
  2. User Wallet top up
  3. User Dashboard

1. User project creation flow

User project creation flow – Step 1.  Image upload interface

User uploads their images.

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

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

  1. When selected, link appears (see screenshot 1)
  2. When link is clicked, popup window opens offering three images to choose from for the day to duck background (see screenshot 2)
  3. 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.  Also, this option cannot be chosen if ‘Day to Night’ has already been chosen,

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

  1. When selected, link appears (see screenshot 1)
  2. When link is clicked, popup window opens offering three images to choose from for the day to duck background (see screenshot 2)
  3. 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.  Also, this option cannot be chosen if ‘Day to dusk’ has already been chosen,

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

  1. On activation, offers a dropdown menu with the various types of floorplans available (Screenshot 1), prices below:
  2. 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)
  3. 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

The Object Removal modification requires the user to describe the object(s) that need removing.  Selecting this option causes a text box to appear for that description, adding a description then hitting Return causes a new text box to appear, there is no limit to the number of text boxes.

To the right-hand side of the text box, there’s a selector for ‘Large/small’ to indicate the size of the object that needs to be removed.

Cost:

Large object removal £3.95

Small object removal £2.95

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 Re-staging

On/Off selector

Selecting this option opens a text box for the user to describe the type of room or add any other instructions.

Cost: £39.95

Note:  If this option is selected, the user cannot progress from the modification screen without entering a type of room.  This option can not be selected if ‘Virtual Staging’ has been selected.

11 Virtual Staging

On/Off selector

Selecting this option opens a text box for the user to describe the type of room

Cost: £29.95

Note:  If this option is selected, the user cannot progress from the modification screen without entering a type of room.  this option can not be selected if ‘Virtual Re-staging’ has been selected.

12 Watermark

On/Off selector

Selecting this option opens a dropzone image upload below the modification table for the User to upload their watermark image

Cost: £0.15

13 Virtual Boards

On/Off selector

Selecting this option opens a dropzone image upload below the modification table for the User to upload their Virtual Board image(s)

Cost: (TBC)

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:  Logged in Ewe_move users get a 30% bonus to top up credits.

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 BACK END

  1. Project page – project status and details
  2. Dropbox – upload to, and downalod from

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;

  1.  README.txt – file with client-specific instructions  (Screenshot 1)
  2. project.txt – file with the requested modifications (Screenshot 2)
  3. All the uploaded images (Screenshot 3)
  4. A ‘samples’ folder that contains an example image of each type of modification requested in the project  (Screenshot 4)
  5. 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

  1. Mod team downloads files from the top-level project folder, does the modifications described in the project.txt file.
  2. 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’.
  3. 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