Documentation

Creating a new database

First thing you want to do before installing Picturish is to create a new database on your mysql server. If you already know how to do this/or have already created one just skip to the next step.

Your host will most likely be running phpMyAdmin as mysql manager, if that's the case here's a step by step guide (if not the proccess will be very similar on other managers).

Login to your control panel, find and click phpMyAdmin link: Click on the database tab in the top menu, enter any name you like and click create.

Uploading Files

After creating a database, unzpip the .zip file you donwloaded from CodeCanyon and upload the contents of Picturish folder to your servers root folder (usually called www or html or something similar) or a sub-directory, shared hosting providers usually have a web based file manager, but you should use something like Filezilla to do the upload as the web based managers can cause various problems fairly often.

Installing Picturish

After you uploaded picturish files, simply open up your site url and follow on-screen instructions to finish the installation.

Updating Picturish to new versions

  • 1. Extract the .zip file you downloaded from CodeCanyon.
  • 3. Upload and overwrite all the files same way you did when you installed Picturish.
  • 5. Visit yoursite.com/update url to complete the update proccess.

Social Login

In order make social login (logging in via google, twitter and facebook) work you will need to register for a corresponding app and get that services Client ID and Client Secret. Check out the section for each service for a detailed instruction for how to register and get those tokens. Once you've got your client id and secret simply enter them in corresponding field in admin area -> third party services and keys.

Facebook

You can resgister for a facebook app Here by clicking on My Apps > add a new app at the top. Once you create the app you can find your id and secret in your app dashboard, you will also need to enter your site url in Settings > site url field and make your app public from Staus & Review tab.

Twitter

You can register for a twitter app Here, after you register you will need to enter your site url in Website and Callback Url fields in your app settings, you can find your key and secret in the Keys & Access Tokens tab.

Google

You can register for a google app Here by clicking on Create new project, after creating new project go to credentials tab and in the authorized redirect uri field enter http://yoursiteurl.com/auth/social/google/login, you might also need to enable Google plus and contacts APIs.

Mail

In order to make mail work (for password reset and other functions), you will need to register for a mandrill API key. Mandrill is used to avoid the many problems that occur when using public smtp servers (like gmail or your hostings private one). Here's how to get your API key.

Register for mandrill api key

To register for mandrill key go to this url, create a new account and then log in. Then click get api keys -> +add api key

Then simply copy mandrill api key and enter it into corresponding field ind admin area -> third party services and keys

Analytics

Registering for google analytics account

Analytics page is powered by google analytics so you will need to register for google analytics and add their supplied code to your site. Here's how to do it.

  • 1. Go to this url You will be prompted to login to your google account or create a new one if you don't have it already. Do it.
  • 2. Click on Admin -> Property -> Create new Property -> fill out required fields -> click on get tracking ID
  • 3. Go to Admin area -> settings -> third party service keys and paste the code into google analytics tracking code field.

Viewing analytics information

Once you have created analytics account and entered it in settings page, go to admin area -> analytics, click on Access google analytics button, then click accept

And you are done. You can now easily view analytics information right from the admin area. You can also select different analytics account, property and view from the bottom of the page.

Users

From users page, you can get an overview of your site users, create a new one, delete existing ones and edit their profile information.

Photos

From photos page, you can get an overview of photos uploaded by all your users and delete them.

Settings

On the settings page you can change various options on your site from your homepage view to user registration. There's a description under each options so you shouldn't have any troubles figuring out which setting does what.

Translating Picturish

It's really easy to translate picturish. Simply open up application/resources/lang/en/app.yml file with a text editor and enter your translations on the right.

Uploading Photos

From dashboard, photos can be uploaded by draging and droping them (or folders) or clicking on orange upload button. While photos are bying uploaded you will see a progress panel at the bottom. Once they are upload you can edit, manage and organize them right away.

Albums

When user creates an account root album is automatically created for them. This is there all photos by default will be stored. New albums can be created by clicking orage new button and then album. Once album is created it can be selected from the left panel and photos will be uploaded to that album instead of root.

Trash

Photos deleted from one of the albums will be moved to trash. Photos currently in trash can bee seen by clicking on trash in the left panel. These photos can easily be restored by right clicking a photo and clicking restore. Photos deleted from trash will be removed permanently from database and filesystem and are impossible to restore.

Recent

Photos uploaded recently can be found in Recent panel. 50 most recently uploaded or modified photos will be displayed here.

Favorites

Favorites page will display photos user has marked as favorite. Photos can be marked as favorite by right clicking on them (or clicking more options button) and then clicking favorite.

Information Panel

Information Panel (on the right) will display various information for currently selected item (photo or folder). It has 2 tabs, details tab will show items preview, action buttons, item details and allow to change or add a description to item.

Activity tab will show all the activity relevant to that item, including when it was created, modified, deleted and more.

Accessing available actions

Various actions can be performed on uploaded photos and created albums. To access these action you can right click on an item, click on more options button above photos or click one of the actions button in the info panel under item preview.

Here is an explanation of all available actions:

  • Preview - preview selected item in a full-screen gallery mode.
  • Open in photo editor - Open selected photo in photo editor to modify it.
  • Share - Open sharing panel to get a link to item preview page, add a password to item or share it via social services.
  • Get Links - Open links panel to get various links to the item (direct, preview, embed, html etc).
  • Move to - Move selected photo to a different album. You can also do this by simply dragging a photo to a desired album.
  • Favorite - Add selected photo to favorited for easy access later.
  • Rename - Rename selected item. This will only change items display name so all the old links will still work.
  • Make a Copy - Copy currently selected photo.
  • Download - Download a photo or a .zip contain all photos in an album.
  • Remove - Move selected item to trash or delete permanently if it's already in trash.
  • Restore - Restore selected item from trash into it's original album.

Changing Home Page

You can easily change what is shown as your homepage from admin area -> settings. You can choose between Landing Page, Login Page or Custom Page. If you choose custom page you will need to enter a path (on your server) or a url (on the internet) to your custom .html file.

Upload from homepage

If you have homepage uploading enabled in admin area -> settings, users will be able to drag and drop their photos directly on the homepage to host and share them without logging in or registering. If user logs in after uploading a photo this way, those photos will be attached to his account automatically and they will be able to manage and edit them.

Basic Image Operations

#Crop

To crop the image click on the corresponding icon in the basics panel. After croping square appears on the image position it where you want by dragging it then click crop to finish.

#Rotate

To rotate an image click on the rotate icon and use the slider to rotate the image, click apply after you are done.

#Resize

To resize an image click on the resize icon and enter the image dimensions you wish to resize to. constrain proportions switch will assure that aspect ratio is preserved. You can also use the percentage slider to resize the image by certain percentage while keeping the aspect ratio.

#Round Corners

To round image corners click on the round icon, select the radius you want and click apply. Note that currently rounded corners will appear jagged on chrome due to a bug in it so you should use firefox or IE if you need perfectly round corners.

#Color

The color icon will change the canvas background. This will only work if your image doesn't fill the entire canvas.

#Merge

Merge will merge all the layers/objects, after this they will not be movable or modifiable, but you will be able to apply filters to everything instead of just the images.

Adding text

To add text to your image open the text tab from the left sidebar and click on the font you want. You can filter the fonts by searching for them by name or selecting a category at the top of text tab and you can change to the next fonts page by using pagination at the bottom. You can choose from all 600+ goole fonts. Double click the text in the image to change its contents. You can change the page appearence from the panel that opens up when you click on text.

Free Drawing

To draw select a brush you want from the free drawing panel and then simply click anywhere on the image and drag the mouse without releasing the mouse button. You will need to change the settings you want in the drawing panel before you start drawing as those settings will not be changable afterwards. Also don't forget to click apply after you are done otherwise the drawing will not be preserved.

Filters

To apply filters to images, open filters tab and the select the filters you want. You can click on the X icon to remove the filter and on gears icon to change it's settings. Note that filters will only be applied to images and not other objects like text and drawings, if you want to apply filters to everything you will need to first merge the layrs from basics tab.

Basic Shapes

From the shapes tab you can add multiple shapes to your image, you can position the shape by clicking on it and dragging it around. You can change a variety of shape settings in the shape panel including applying a custom background to it.

Layers/Objects

You can manage all the objects in your image from the object panel on the right. Click on object to select it, click on the eye icon to toggle it's visibility, click on the trash icon to delete the object and click on the lock icon to lock object in place preventing it's movement via drag and drop. You can also control objects z-index by changing their order in the objects panel.

History

Almost all of your actions will create a new item in the history panel so you can easily jump around to various points in time in your project from it by click on a specific item.

Support

If you have any problems or questions, please use the contact form on picturish codecanyon page support tab to send us a message instead of doing it in the comments, so we can resolive it as fast as possible, thanks!