JV-LinkDirectory - Getting Started
If you have just bought JV-LinkDirectory (or JV-LD) then this article will help you in getting started. Please make sure that you follow all the instructions in this article to get your directory up and running as soon as possible!
Step-1: Read the Concepts First!
It is important that you read the basic concepts of JV-LinkDirectory before you proceed with installation or any configuration. JV-LD is a very comprehensive product, and answers to most of the questions can be obtained from our documentation, and for which understanding the concepts if very important. Please read the basic concepts.
Step-2: Install the software
Follow the instructions at www.jv-extensions.com - 'Downloads' menu to download the latest version of JV-LinkDirectory. The component when installed will automatically install the modules and plugins. So for most users, installation of component should be more than enough, unless you need special plugins that need to be installed separately. Please read JV-LinkDirectory Installation Instructions
Step-3: Install Sample Data
After the installation is complete you can install Sample Data for the directory. Doing so will create a pre-defined set of categories and listings in your directory. JV-LD configuration will be set to generic settings during this sample data creation. Installing sample data helps you get started with JV-LD, and also helps you learn and use everything about JV-LD much faster. Read instructions to install sample data in the directory
Alternatively, you may quick start with more detailed configuration using the Jump Start Configurator. Jump Start Configurator will ask you few minimal questions and will install directory elements for you. Read instructions to use Jump Start Configurator in the directory
If you do not wish to install sample data or use Jump Start Configurator, then you may skip to step 4
Step-4: Create Frontend Menu Item
The next step is to create a menu item pointing to "Directory Home" of JV-LinkDirectory. This will enable your users to access the directory powered by JV-LinkDirectory, add listings and browse the directory pages. Read article on creating menu items
Step-5: Set Permissions for Directory Actions
This is a very important step where you will setup the access control permissions for different types of users for varieties of actions that can performed in the directory. Visit the Backend JV-LD Dashboard, and click on Options button at the top right hand side of the screen. In the options screen, browse through the user groups and set permissions for the usergroups to perform the actions like adding link, show user profiles, submit link exchange requests etc... Read instructions to set permissions for directory actions
If you don't do this, users will not be able to perform these actions from site front-end. Please ensure that you set the default view access for new listings as described in the article linked below.
Step-6: Setup CRON job
JV-LD has numerous background operations that are costlier if done on page loads. So to run these operations, you must setup a cron job with hosting provider. This step is mandatory for JV-LD to function properly. Please read article to setup CRON job for directory.
Step-7: Create and Setup Categories
Categories are the main containers for listings in JV-LD. Go to JV-LD Categories section and create categories and sub-categories. Please remember to set the necessary configuration in the "Options" tab of Create/Edit category screen as required. To create hundreds and thousands of categories in bulk you may visit the Utilities section and use the "Import Categories from Text File" utility.
Step-8: Create Listing Plans
Just like how listings belong to categories, they also are associated with a listing plan. A listing plan decides many things for a listing. This includes maximum number of profiles for that listing, maximum number of photos, videos, files etc... These limits and limitations are set on listings by the listing plan associated with that listing. As admin you can also set a price for a listing plan. Anyone who wishes to add a listing needs to choose the listing plan first and pay accordingly, before he/she can add his listing. You can create multiple listings with different limits. For example, you can create a listing plan "Plan A" which allows 3 photos and 3 videos, while "Plan B" allows "15 photos and 20 videos". You can set them to be FREE or set a price to each of those listing plans too!
Visit the JV-LinkDirectory back-end - Listing Plans menu to the left, and start adding your listing plans. Once you add your listing plans, please ensure that you set a default plan, and fallback plan. Read more about Listing Plans
Step-9: Enable Frontend Images Upload
Being a directory, you may want users to your site to be able to upload images for their listings. This means that you must enable your site visitors to upload files (banners, logo files etc..). JV-LD uses the Joomla media manager to let your site visitors upload files while adding links via site frontend. Joomla must be configured to allow this in the first place. Read more on enabling frontend image upload for users
Step-10: Configure the Directory Options
Go to JV-LD Configuration settings and configure the component. There are 150+ configuration options and comprehensive help is provided for each option in the configuration screen itself. Most of the options have been set to default values which can be left intact unless you want to customize them.
Step-11: Add Listings or Links to Directory
Go to JV-LD Listings section and add listings to the categories. To create hundreds and thousands of links in bulk you can visit the Utilities section and use one of the link import utilities provided.
Step-12: Bring the Directory Online
Any installation or upgrade will automatically bring the directory offline. So once you complete the above steps, do not forget to bring the directory online from admin backend. Directory will be accessible to frontend visitors only if it is ONLINE. Read article on toggling directory online status
Step-13: Configure the Directory Modules - Optional, but Recommended
Go to Joomla Module manager and configure JV-LD modules and enable them as require. Read article on modules configuration