JV Pin

This guide will show you general concepts, features of JV Pin and how to configure this component to quickly build your own social network on your Joomla!. 

INTRODUCTION

As you have already known about Pinterest - a great social network for photo lover. Here we have JV Pin -  flexible social networking extension for Joomla!,  which helps you to build unique online communities where the members mainly share photos, videos.... Sharing photos is the heart of a community, everyone loves it. JV Pin could be used  for small enterprises, business, schools, gamers, sport fans or other communities too. JV Pin is designed to quickly build member base with great features. Don't wait further, experience the feeling of being a host in an interesting community. 

 1.JV Pin Frontend User Basics

PINS

A pin is an image (or video) you add to website that links back to the original website it came from. This means that pins often lead to a place with useful information, such as a recipe, an interesting article or something you can buy.

There are a few ways to add pins:

    Click “Pin it” on any pin you see on the website

    Add the “Pin it” button to your browser to pin from websites

    Hover over “+” at the top of the website to upload an image from your computer or find one from a website.

 


 

BOARDS

A board is where you collect your pins. You can invite other people to pin with you on any of your boards. If you’re planning a surprising party with friends, you might want to create a secret group board.

Make boards for anything and everything – hobbies, interests, ideas, projects, travel plans, cooking adventures – you name it! 

 


 

FOLLOWING

Following people and boards is how you fill up your home feed with interesting stuff. It's all about what you like, not just who you know, so if you come across someone who pins things you love, follow them and you'll see their new pins in your home feed.

If you want to follow a person, click “Follow” on their profile to follow all of their current boards and any new ones they create. To follow just one board, click Follow beneath the individual board.

Just a note: when you follow group boards, you'll see pins from anyone who pins to that board. This means you might see pins from people you don't follow.

 


 

HOME FEED

When you first log in, you’ll land on your home feed. This is a collection of pins from the pinners and boards you follow, and it updates every time a new pin is added. If we ever have recommendations, you’ll see them here. 

 


 

YOUR JV PIN ACCOUNT

To get to your profile, just hover over the username and then click on “Settings”. 

From here, you can change your username, display name, password, location…. Your display name is what shows up on your profile and on pins you interact with. Your username is what shows up in your profile’s address.

Changing your profile picture is easy – click on the current image to upload new one from your computer. 

Click “Save” when you’re done.

 


 

2. User Features
  • Creating user account
  • Search pin, board, and user
  • Mentioning feature (for comment)
  • Login with Facebook
  • Login with twitter
  • Upload image (pin)
  • Upload link video (pin)
  • Following function for both user and board.
  • Like button for pin
  • Re-pin (similar to Facebook share)
  • Comment system.
  • Reporting a pin or comment
  • Editing pins
  • Recording activity (what activities of other user in your pin/board)
  • Inviting friends via mails.
  • Find friends on Facebook
  • Find friends on Gmail
  • Sharing a board between users.
  • Add this function
  • Receiving Badges (awarded from back-end).
  • Pinit function. 

 


 

INSTALLATION

1.INSTALL WITH QUICKSTART PACKAGE

Quick-start installer will create an entire new Joomla site with JV Pin , data and all the related extensions installed, essentially a replication of JV Pin demo site. If you are new to Joomla quickstart is the best choice for you. The procedure may take a few minutes to complete.

Please refer to the following guide for further details:

 

2.INSTALL JV PIN ON JOOMLA 3.2

Installing JV Pin on Joomla 3.2 allows JV Pin to be installed on an existing site (instead of creating entire new site). 

To install JV Pin, take the following steps: 

Step 1: The first thing you need to do is to download  JV Pin zip file. This file includes JV Pin Template & Component

Step 2: Once you JV Pin zip file downloaded on your computer, login to the administrative area of your Joomla website and Upload & Install JV Pin the through the Extension Manager (Extensions -> Extension Manager). The process is the same for templates, modules, plugins and components

jv pin installation

Step 3: Set default for JV Pin: Go to Extensions => Template Manager => Tick JV Techno => Click Default in the top left corner

make default

✔ Step 4: Enable Extension "Ajax Call" of plugin " System - JV Libraries"

Go to Extensions => Plugin Manager search Plugin "System - JV Libraries"  click on it to access new page

plugin jv libraries

In the plugin manager page, choose tab Extensions on the left corner, then enable Extension "Ajax call"

enable ajax call

✔ Step 5: Assign JV Pin to menu

Go to Menus => Main menu => Choose an item to assign JV Pin

Select menu item type: JV Pins , Click Save to finish 

assign jv pin

 

 


 

Feature Explanations

1.Login

By logging in, you will be able to access a lot of wonderful features of JV Pin.

Click “Login” in the top left corner

Enter you username and password. You could log-in through Facebook, Twitter or Google provided that you registered. We will show you how to register in Global Configuration part.

login jv pin

 


 

2.Using Notification

 Notifications tell you when someone pin, like or comment on your pins, follow you or one of your boards, or mention you in a  comment.

Click the red button in top left corner to show notifications

using notification

 


 

3. Managing YOUR Home Feed

Your home feed is where you’ll find all sorts of new and inspiring things to add to your own boards.

manage home feed

To return to your home feed, click the Logo "JV Pin" on the top (number 1)

To show pins of users you are following, click following (number 2)

To sort which category of pins shown on your home feed, click Categories  (number 3) ( in the picture above, category design is selected)

To show all pins on your home feed, click everything (number 3)

Click the symbol on the top right (number 5) to reload your home feed

You can easily sort the pins order by any field (number 6) in an ascending (ASC) or descending(DESC) order (number 7)

 


 

4.Using search bar

Just type what you’re interested in finding into the search bar and enter (number 1)

You’ll get a page of results displayed on the page.

Narrowing your search results:

   Once you have searched for something, you can toggle between types of results by clicking the Pins, Boards, and Users buttons in the top left-hand corner (number 2).

using search bar 

 


 

5.Upload Images

Hover over “+” button beside your name in the top-left corner 

Click “Upload Image” on menu bar

Choose an image from your computer

upload image

 


 

6.Adding New board

Hover over “+” button beside your name in the top-left corner then click “New Board”.

adding new boards

A popup window will be shown to add information to new board

Enter a name, choose a board category and add description to your board.

Click “Create” when you're finished

adding new board popup

 


 

7.Finding images from URL & PIN IT

Hover over “+” button then click “Find from URL”

finding images

A popup windown will be shown, insert URL and click “Find” .

find image from url

 

JV Pin will automatically load all the large images from the URL and display them on the page.

You can save the images or "pin it" by clicking on 1 of the images. A pin-it popup  will be shown

Choose the  board to save pin (number 1), add information to Caption (number 2) then simply click “pin it” (number 3). So the image you like is easily collected to your board.

find images from url

 


 

8.Adding Pin it button to bookmark

Adding the Pinit button to bookmarks bar will enable you to easily add to your boards while you search the web. 

Ensure that the bookmarks bar in web browser is enabled

Drag Pinit Button to bookmarks bar  

adding pin it button to bookmark bar

 After you have your pinit button added to bookmarks bar, everything will be more easier to search for images and pin any stuff you like. So convenient and interesting 

9. What can you do with a Pin?

After some had pinned a thing, It simply became a pin. There are many interesting actions you can do with it:

Repin: when you see an interesting pin, you'd like to pin to your board.  Just repin it (number 1)

Like with like button (number 2)

Leave a comment on a pin ( number 3)

Edit your pins by clicking on Edit ( number 4)

When you see a inappropriate pin for general public, you can report to admin ( number 5)

 

jv pin interaction

 


   

10. Inviting friends

Hover over your username account (number 1)

Choose Invites (number 2)

 

inviting friends in jv pinterest

 You can invite friends from Facebook, Twitter, Google provided you registered Social Network (number 3). To know how to register please check in Global Configuration Part

inviting friend in jv pinterest

 


 

11. Mentioning someone

When you are leaving comment and want to mention someone (your followers or people you are following) on a pin, just include the "@" symbol beforehand. As you type a letter of someone's name, a drop-down menu will appear that allows you to choose from your list.

The one you mention on a pin will receive a notification.

mentioning feature pinterest

 


 

12. Your Profile

To access to your profile page, hover over “Username” (number 1)  then click on any item ( number 2) to access to your profile page.

your profile

After accessing to your profile, you’ll see tabs which are similar to the vertical menu in the above picture.

your profile

Explanations: 

  Setting: to edit your profile (email, password, name, avatar…) (number 1)

  Badge:  show user's badge icon ( the ion image  based on admin settings ) (number 2)

  Boards: show all your boards on the page (number 3)

  Pins: show all your pins on the page (number 4)

  Liked: show pins you liked (number 5)

  Activity: show your recent activities (number 6)

  Followers: show your followers (number 7)

  Following show the users you are following  (number 8)

  Follow boards:  show boards of the user(s) you are following (number 9)

  Repins from:  show the user(s) you re-pinned their pin(s) (number 10)    

 


 

 13. What can you do with your board?

Edit your boards. Go to a board you'd like to edit and click Edit (number 1), make any changes to the board info, click Save. Click delete if you want to delete the board 

Set cover for your board (number 2): Hover over the board, click Set Cover, select a pin and click OK when you're done

 

manage your board in jv pinterest

 


 

14.Follow/ Unfollow a person & boards

Following a person means you'll see that person's pins in your home feed. If he/she creates a new board, you'll automatically follow it.

Following a board means you see new pins added to that board in your home feed.

You can unfollow people or boards at any time – the person won't be notified.

To follow/unfollow a person, click Follow/ Unfollowon his/her profile page. When you follow a person, you follow all their board ( number 1)

To follow/unfollow a specific board, click Follow/ Unfollow at the bottom of the board. (number 2)

follow fucntion in jv pinterest

 


 

Managing JV Pin

This section allows you to manage: categories, boards, pins, comments, profile, badges.

In the back-end, go to Components >> JV Pin 

manage jv pintertest

1. Categories

Within this section, you can:

- Click on "New" button to add a new category

- Edit existing categories,

- Did meta keyword, meta description for the categories...

- View number of boards and pins in each category

- View status of the existing categories

manage categories in jv pintertest

2. Boards

Within this section, you can:

- Manually add a new board by clicking on "New" button

- View list of existing boards

- View status, number of pins in each board

- Access to each board to edit, view info

manage boards jv pintertest

 

3. Pins

Within this section, you can

- View all pins, status, comments on pins...

- Select to delete pins

- Access each pin to edit, view pin info

manage pins jv pintertest

4. Comments

With in this section, you can

- View all comments, comment author, created date, status

- Delete comments

- Access to edit comment, view more info

manage comments jv pintertest

5. Profile

Within this area, you can do the followings:

- View all user profiles

- Delete user profile

- Access to each existing profile to edit/view info

manage profile in jv pintertest

6. Badges

 

In this section, you can do the followings:

- Add new badge and edit it

- Access to each badge to edit info, upload your own badge image

manage badges in jv pintertest

7. Manage users

In the back-end, navigate to User >> User Manager

In this area, you can do the following:

- View current users

- Manually add new users

- Manually activate user

- Access to each user to edit / view user info

manage users jv pintertest

 


 

Language manager

If you are planing to use JV Pin for a non-English social network, you may need to change text into your own.

There are two ways to manage language:

1. Edit core files

The file you can edit text is en-GB.com_jvpin.ini located in directory: jv_pin/language/en-GB. 

Open the file and search for the text you want to change

2. Language overrides in Joomla

Log into back-end, go to Extensions >> Language Manager

Then on the sub-menu on the page click on "Overrides" as shown in the image below

language manager in joomla 3.3

Click on "new" in the toolbar to create new override or click on existing overrides to edit

In the edit override page, you will see the form for creating the override on the left side of the page , however you can't create it until know what you want to override. On the right side of the page is a search utility to help you find what you need.

The instructions give you the basic information you need to understand what to search for. If you're just getting started doing this, you will want to use the "Value" method. "Value" is the text you want to search/ "Constant" is the string you want to search.

edit override

Type the value in the search field, and make sure you have chosen value as the method. You can see the results when I searched for "follower" below  

edit override

Finally, change text into your own language and click "save" when you are done.

 


 

GLOBAL Configuration

Accessing JV Pin Global Configuration from Back-end allows you to configure parameters affecting Front-end appearance.

Login to the administrative area of Joomla website, navigate to System >> Global Configuration >> Choose JV Pins to configure JV Pin Component as you can see in the pictures below:

access config

global configuration

1.Settings

In this tab you are able to configure layout, logo, image size 

Please check the parameter explanation in the picture below

settings 

2.Recaptcha

Using Recaptcha App helps you prevent automated abuse of your site  (such as comment spam or bogus registrations)

recatcha

Parameter Explanation:

Active captcha: select activate/deactivate Recaptcha App

   •  Public key: insert Public key to set up Recaptcha App

   •  Private Key: insert Public key to set up Recaptcha App

   •  Max request time: set maximum value (in times) for timer to display recaptcha checkbox request, set 0 to always display recaptcha checkbox

   •  Time reset: set value (in seconds) for timer to reset count request, set 0 to disable recaptcha

Note: Values can be set for the sub categories: add new pin”, ‘add pin from Url, edit pin, delete pin, comment to pin, report comment, add new board, delete board, follow board, set cover board, register user, edit user, follow user and login

recaptcha

3.Social

To be able to login JV Pin or invite friends through Social Network you need to register and get API & Secret ( Facebook ) , Key & Secret ( Twitter ),  client ID & Secret ( Google )  then insert into the blanks as you can see in the picture below

social app

 

4.View Pins

In this tab, you can configure your home feed. There are 3 sub tabs in the home feed: Following, Category, Everything. You can set 4 parameters for each individual tab.

view pins

Parameter Explanation:

   • Default order by: select default order for your pins displayed on home feed

   • Default order direction: select order direction for your pins displayed on home feed

   • Limit result: set a limited result of pins displayed on a loading time 

   • Comment result: set a limited number of comment on a pin displayed on home feed

 

5.View Users

In this tab, you can configure user profile page and sub-pages: boards, pins, liked, followers, following and follow boards. 

view users

 

Parameter Explanation:

   • Show badges: select to show/hide “Badge” symbol for user in user page

   • Default sub: select the default sub item as access user page

   • Default order by: select default order for displayed on user profile page

   • Default order direction: select default order direction  displayed in user profile page (DESC/ASC)

   • Limit result:  set a limited result displayed in user profile page on a loading time 

Comment result: set a limited number of comment on a pin displayed in user page

 

6.Setting "View Board"

view users

Parameter Explanation:

   • Default order by: select default order for board’s pins displayed in front-page

   • Default order direction: select default order direction for your board’s pins displayed in front-page

   • Limit result: set a limited result of board’s pins displayed on a loading time 

   • Comment result: set a limited number of comment on a board’s pin displayed in front-page

 

Back-end setting:

user backend

 

Front-end Appearance:

user front end

 

7.View Pin

view pin

✔ SUB LIKES

view pin

Parameter Explanation:

  • Default order by: select default order of users(who liked the pin) displayed in front-page

  • Default order direction: select default order direction of users (who liked the pin)  pins displayed in front-page

  • Limit result: set a limited result of (who liked the pin)  displayed on a loading time 

 

 SUB REPINS

sub pins

Parameter Explanation:

  • Default order by: select default order of users(who repined) displayed in front-page

  • Default order direction: select default order direction of users (who repined)  pins displayed in front-page

  • Limit result: set a limited result of (who liked the repined) displayed on a loading time 

 

8.View Search

view search

Parameter Explanation:

  • Limit result: set a limited result of searched stuff on a loading time 

  • Default search: select default  category  for stuff search

 

 Back-end setting: 

view search backend

Front-end Appearance:

view search frontend

 


 

 HOW TO GET FACEBOOK API & SECRET

Start logging-in your Facebook account and go to the App Dashboard. If you haven't created an application before you will be prompted to register. Note that you have to verify your Facebook account to create apps on Facebook.

social app

social app

social app

 Fill in App Name and App Namespace

social app

social app

 

 


 

HOW TO GET TWITTER KEY & SECRET

Go to Twitter developer area, sign in with your Twitter Account 

Go to My Application ==> Create New Application

 Fill in the Application Details

twitter account

twitter accoun

 


 

HOW TO GET PUBLIC & PRIVATE RECAPTCHA KEY

 Log in your google account

 Go to the address: https://www.google.com/recaptcha/whyrecaptcha to sign up 

recaptcha

Click Sign up, insert your domain, click Create key

recaptcha

 

recaptcha