Widgets
From: Using Back-End
Contents
Sidebar Widget
Sidebar Widget (Widgetsgroup) contains a group of widgets. We named it sidebar for a reason. You can set them as default sidebar. But that's not the only use case. Every place that need a widgetsgroup, it can use sidebar widget. Even widgets or themes can use them.
To manage Sidebar Widgets go to the Widgets/Widget Manager. Click on Add Widget and
1. Enter a caption for your sidebar widget group. For example, Left Sidebar Widget.
2. On widgets section you should have some widgets, Select one of them and click on Add button. Then add another widget.
3. Fill widgets settings.
4. Select a Default language. For example, English in int language group.
5. Select Right as Default: Position.
6. Select Area 1 (Theme should support it).
7. Click on Add button.
Now, go to that language on the front-end. The widgets group should be in the right sidebar of your website.
You can also create a sidebar widgets for a category, If you fill Default: Category value. For example, if you set Default: Category as Products and open a post related to the Products category. That sidebar widget will be shown.
To sort and change order of the widgets inside widgetsgroup you can drag the widget title and drop it in other place.
You can also get sidebar widget with jv_loader_widget_get() function on the front-end.
Inpost Widget
Inpost widgets can be used inside your post content. You can create them inside Posts/Add Post but to edit them you need to go to the Widgets/Widget Manager and find your inpost widget by caption or id.
You can also get inpost widget with jv_loader_widget_get() function on the front-end.
Post Tool Widget
Post tool widgets will be shown inside post standard positions. There are four main positions. Top, Bottom, Bottom 2 and Global1.
Post tool widgets can have specific settings for each post. To configure a post tool for each post, go to the Posts. Add or edit a post. In Post Tool tab, you can find post tools and configure them.
You can also get post tool widget with jv_loader_widget_get() function on the front-end (We call it anywhere position).
Sorting
You can sort post tool widgets. To do that, go to the Widgets/Post Tool. You can change the order with drag and drop.
No matter on what position they load, they will sort exactly by the selected order.
Settings
Post tool widgets default settings and position can be change inside Extensions:
1. Click on extension settings.
2. Go to the Widgets tab.
3. Select your post tool widget.
4. Change the position by selecting one of these positions:
- None: Do not show widget at all.
- Top: Show in top position.
- Bottom: Show in bottom position.
- Bottom 2: Show in bottom 2 position.
- Global: Show in global position.
- Top and Bottom: Show in both top and bottom position.
- Anywhere: Only show when requested.
You can also change the post tool visibility in list and post. To do that, select one of the options in the View select box.
Widgetspage
Widgetspage widgets are back-end widgets. These widgets have a page in back-end to do what they want. You can find them in Widgets.
For example, if you have comments extension and you want to manage comments posted by your website users, go to the Widgets. In the left side, click on the Comments: Comment link. Now you are in Comment widgetspage.
Noti Widget
Noti widgets will be shown in the back-end notification box.
Board Widget
Board widgets will be shown in the back-end index page. They can show information or allow you to manage something.
Super Widget
Super widgets are front-end widget. They can do whatever they want. They can do something without having visual output in the front-end.
Settings
Super widget settings can be found inside Extensions. Click on settings. If super widget have settings, you should see that inside Widgets tab.
Admin Post Widget
Admin post widgets are back-end widget. They can do something when back-end add, edit or delete.
Settings
Admin post widget settings can be found inside Extensions. Click on settings. If admin widget have settings, you should see that inside Widgets tab.
Calling front-end Widget by jv_loader_widget_get() function
The widget you are calling by jv_loader_widget_get() function, must be enabled and has permission to call as anywhere widget, otherwise the result will be NULL.
Parameters
e_name: String of the extension name. For example: 'My Extension'.
w_name: String of the widget name. For example: 'My Widget'.
meta: Array of widget meta to pass to the widget. Default is NULL.
start: String. This string will be at the start of the result if the result is not empty. Default is NULL.
end: String. This string will be at the end of the result if the result is not empty. Default is NULL.
thconfig: Array of theme configuration. Default is NULL.
Example
If you want to call a widget, you need to know about widget meta of that specific widget. For example, Here we call Menu widget from Main Tools extension:
<?php
//Widget Meta Array
$meta = array();
$meta['menu'] = 10; //Menu Group ID
//start and end (The result will be wrapped up in DIV block)
$start = '<div>';
$end = '</div>';
//thconfig Array
$thconfig = array();
$thconfig['imgType'] = 'img:normal'; //load normal size for picture
$thconfig['imgLargeType'] = 'img:large'; //load large size for big picture
//Print Menu Group (ID=10)
echo jv_loader_widget_get('Main Tools','Menu',$meta,$start,$end,$thconfig);
?>
- 1. Themes decide where to show these positions.