Socialmediabox Administration Guide

Transcript

SOCIALMEDIABOX ADMINISTRATION GUIDE (Version: 1.0, January 2016) This guide explains how to use the basic functionalities of the SocialMediaBox v. 2.0.0.0 Legal notice The information in this manual is furnished for informational use only. No part of this manual may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the prior written permission of ATHENSA LLC. The software, described in this manual, is owned by DMT Ltd and ATHENSA LLC. It is protected by Bulgarian Copyright Law, as well as by international copyright treaties, and may be used or copied only in accordance with the license agreeme nt. ATHENSA LLC provides this manual “as is” without any warranty, either express, or implied. This publication may contain typographical errors or technical inaccuracies. While every precaution has been taken in the pre paration of this document, ATHENSA LLC assumes no responsibility for errors or omissions. Nor is any liability assumed for damages, resulting from the use of the information, contained herein. Changes are periodically made to the information herein. They will be incorporated in new versions of the manual. Please, check the ATHENSA website regularly for User Manual updates. DMT Ltd. and/or ATHENSA may introduce changes or improvements in the products, described in this manual at any time, without any special notice. Please, address your comments or questions to: ATHENSA LLC 2970 Clairmont Road NE, Suite 640, Atlanta, Georgia 30329, USA Tel. +1 (404) 424 9283 Fax +1 (404) 835 1705 [email protected] [email protected] https://athensa.tv/ Contents Legal notice ...........................................................................................................................................................................................2 Preface...................................................................................................................................................................................................4 Style Conventions ..................................................................................................................................................................................5 Getting Started ......................................................................................................................................................................................6 QUICK START AND SETUP......................................................................................................................................................................7 User Interface.........................................................................................................................................................................................8 HOME VIEW .......................................................................................................................................................................................8 SETTINGS ...........................................................................................................................................................................................8 Manage System................................................................................................................................................................................10 User Accounts ..................................................................................................................................................................................14 TitleBox Templates ...........................................................................................................................................................................16 Bad Words........................................................................................................................................................................................19 Facebook App ..................................................................................................................................................................................19 Twitter App ......................................................................................................................................................................................20 CREATE TITLEBOX CONFIGURATION....................................................................................................................................................22 EDIT TITLEBOX CONFIGURATION.........................................................................................................................................................23 CREATE USER ACCOUNT......................................................................................................................................................................24 EDIT USER ACOUNT.............................................................................................................................................................................26 APPENDIX 1 -Integration of SocialMediaBox with TitleBox...................................................................................................................27 Preface Dear ATHENSA customer, Thank you for purchasing our product! We would like to assure you that you have chosen the most cost -effective and versatile TV automation system on the market. As always, we are trying to stay close to our customers’ needs, making sure they all receive adequate support and satisfaction. Your opinion about our product is an exceptionally valuable source of information for us. The ease of working with the ATHENSA products results mainly from the suggestions and comments of our current respected customers. This manual is structured into several sequential chapters, each aiming to ease the installation, fine tuning, and use of our products. We hope that you will enjoy working with it, and we are anxiously looking forward to receiving your feedback. Please, send your questions, suggestions, and assistance requests to: [email protected] Helpdesk fax number: +359 2 9717700 Style Conventions File names, software, documents or terms are written in italics The data is written in the settings.ini file. The file is located in C:\Program Files\DMT\AirBox For further information read Shortcuts reference book. The VTR is controlled via RS-422. Direct quotations from the computer screen are presented as follows: Menu Items and commands Tab/Page names Column names (i.e. in a playlist or another grid) Field names, check boxes Buttons Screen readings are written in [square brackets] The keyboard keys are enclosed in <> signs Terms are defined in the Glossary at the end of the manual The arrows, used in the setting procedures mean as follows: A menu item follows; A page(tab) name follows; A field name, a check box name, or a value name follows. Except for arrows, you can distinguish between the relevant menu categories also by the styles, listed above. Getting Started The SocialMediaBox is a web-accessible client/server application for previewing, selecting, editing, and extracting feeds from different social media for the purposes of displaying them on TV. It is a customizable web interface allowing the user to fol low comments from various web pages on a single screen. This is extremely useful for TV shows, which have fan pages on different web sites. Comments from those fan pages can be viewed on a single screen, easily selected, edited and placed in a customized list, which can be displayed on TV. This can be done in real time and is very suitable for live shows, where speed is essential. The SocialMediaBox supports multi-user access, as well as multiple outputs. With one application you have many user accounts, from which multiple customized lists can be created. The access to each list can also be configured. Lists can be private, accessible by selected users or accessible by all users. Thus, a single instance of the SocialMediaBox can be used for several TV shows or even several channels. QUICK START AND SETUP When you first start using the SocialMediaBox, you need to integrate your social media accounts with the system and select the posts that you would like to follow. To do this, you need to go to Settings>Manage System>TV Channels>Edit TV Channels and enter your accounts. Then go to the home page, select a TV channel, create a Tab and select feeds from your accounts you would like to view in the SocialMediaBox. Note that each social media has its specific configurations. Currently, Twitter, Facebook and RSS feeds are supported. User Interface The SocialMediaBox user interface is very easy to use. It consists of two main modes - a Home page displaying feeds of all social media that are integrated, as well as a setting menu. To switch between the two modes use the Menu button placed at the top right corner of the application. You can view the two modes displayed in the screenshots below. HOME VIEW SETTINGS User Settings - Here you can view and edit your personal details and view the system's login history. Help - Here you can access the system help. This command is under development and it is not implemented for now. About – Here you can view product information – like name and product version, as well as license type. Also, you can follow external links to our official website and support portal. Logout - Use this option to log out of the system. Manage System - Here you can view and edit the available user accounts and integrate social media accounts and TitleBox configurations with SocialMediaBox. Let us look at this menu command more closely. Manage System To access the Manage System setting, click the Menu button at the top right corner of the screen to switch to the Settings menu mode. The Manage System is the last menu item (Settings>Manage System). A submenu is invoked: NOTE: Only Super Admins have the exclusive rights to view and customize all available Manage System settings The submenu consists of the following items: System Settings – this feature is under development and currently is not implemented; System Notifications – Here you can view the system updates and user login fails history; TV Channels – Here you can create TV channels and edit all available TV channels configurations; TitleBox Management - Here you can create TitleBox configurations and edit the existing ones; User Accounts – Here you can create user accounts and edit the available user accounts. User Login Fails To access User Login Fails: On the Settings Menu, click Manage System>System Notifications>User Login Fails Using this feature Super Admins can monitor the successful and failed login attempts for the system in order to detect unauthorized ones. The User Exists column displays whether a particular username exists (indicated by a green tick sign) or not (indicated by a Red Cross sign). NOTE: A username could be considered as a not existing due to a typing mistake while logging in the application. However, if you notice a number of incorrect user names having the same IP address, this might mean that someone is trying randomly to guess the username in order to log in without authorization. The Date column provides you with the information about when the user has either logged in or has attempted to log in. The Username column is self-explanatory, while the Remote IP column consists of the IP addresses of the machines that the users use to access SocialMediaBox. By using the Show More Info about users’ login activity. button, located in the first More Info column, you can get more detailed information Create TV Channel To go to Create TV Channel: On the Settings Menu, click Manage System>TV Channels>Create TV Channel The following form is available for you to create a TV channel by entering the corresponding name in the field below. Description and Additional Info fields are optional. However, you are given the ability to choose how much writing space you need. Point your mouse at the resize icon in the fields’ bottom right corners. Pull up to shrink the field and down to enlarge it. The Logo(s) field is under development and it is not implemented for now. Edit TV Channels To configure Edit TV Channels: On the Settings Menu, click Manage System>TV Channels>Edit TV Channels In this page you are able to manage already existing TV channels. TV Channel name - To change a TV channel’s name, click the corresponding Edit button Further on this section, you will get detailed information about the rest of the columns’ functionali ty in this table as follows: User Accounts Once you have created user accounts in Manage System>User Accounts>Create User Account you are able to assign them to chosen TV channels. Click the corresponding User Account icon users listed below, use the bottom scroll of the screen: to view all available users in the system. To see the hidden Super Admin column displays the users who have Super Admin rights in the system as a whole. This column’s funtion is only informative and it doesn’t refer to a concrete TV channel. Assign User feature consists of the Assign /Unassign button. Click this button in order to switch between the two commands for the currently chosen TV channel. User Role column allows you to define a role for the assigned users giving them different rights to operate within a channel. From the drop-down list you can choose between User and Admin roles. IMPORTANT: SocialMediaBox has three pre-defined roles: Super Admin, Admin for a single channel and User for a single channel. Each role defines a set of actions (capabilities) a user assigned a role is allowed to perform, described below as follows:  Super Admin – somebody with access to all available administration features and all other features in SocialMediaBox. There might be more than one Super Admin in the system, as long as the owner is willing to create them in System Manage>User Accounts>Create User Account. The following capabilities are available to Super Admins: - have a full access to all available menu settings (including the Manage System feature); - are able to operate within all TV channels in the system, i.e. to create Thematic Tabs, to feed them with content, to create Lists and to output feeds on the Home page.  Admin – somebody who has access to all administration features within a single TV channel and is abl e to operate within a single channel. All administrators have the following capabilities: - Are able to configure some menu settings concerning their channel - Manage System>TV Channels>Edit TV channels setting and could assign new users to the channel; - are able to operate within the TV channel(s) they are assigned to, i.e. to create Thematic Tabs, to feed them with content, to create Lists and to output feeds on the Home page.  User - they have limited capabilities. They can only select feeds from the Tabs, create Lists and output social media content within their channel on the Home page. TitleBox Templates Click the corresponding TitleBox Template icon. Then click the following TitleBox Configuration button below: You will invoke the consequent window that contains two sections – TitleBox Configuration and Add New TitleBox Template Configurations: 1. TitleBox Configuration section – displays TitleBox configurations’ details, like IP address and port number of the server where TitleBox is installed. These configurations are pre-defined in Create TitleBox Configuration. 2. Add New TitleBox Template Configurations - Here you can add already created TitleBox Template Folders which are set in Create TitleBox Configuration. Name the template configuration. To assign the template, click the Scan templates folder button in the Mapping section. A list of all available TitleBox templates, available in the TitleBox_Templates folder will be displayed below. Click a template to select it and start mapping news item elements to the objects in the template. A dialog will be appended with mapping objects, as shown in the screenshot below: Mapping object - SocialMediaBox Mapping objects - TitleBox Mapping is assigning elements (i.e. images of texts) from the news items in SocialMediaBox, to objects (rolls, crawls, pictures, etc.) contained in the TitleBox project. All available elements of a list item are listed to the left. A list of matching object types from the TitleBox template is displayed to the right of each element. Object names are extracted from the TitleBox project and each is preceded with the object type (i.e. image or text) in square brackets. You can map and display the following social media content: Social Media Name – the name of the source media (Facebook, Twitter, RSS feed); Social Media Img – the logo of the media source; Author Name – the name of the media story creator (i.e. Facebook page or Twitter profile); Author Avatar - the Facebook profile picture/ Twitter avatar of the media story creator (i.e. Facebook page or Twitter profile); Item Date Time – the date and time when the post was created; Item Subject – the caption of the item; Item Message – the full/body text of the item (as displayed); Item Photo – image, contained in the story. For each social media element, only appropriate TitleBox object types from the project will be listed, i.e. images for the avatars and text objects for names and messages. Simply click on object’s name to map it and it will be grayed out as selected. You can only map objects which will be displayed in the output. When you are ready with all mappings, click Create. The assigned template folder will occur below: Click the Edit button at the top right corner if you want to change the mapping settings. Then select the Status from the drop-down list. Choosing the Active status will allow displaying the current TitleBox template in a list of selectable items on the homepage when outputting feeds. If you choose the Archived status, you will not be able to select it for output. To discard a mapping, click Cancel. When you are done editing, click Save. Bad Words In this table you can add words to be replaced by the system in the feeds. This option is ava ilable for censorship purposes. To add a new word to be censored, enter the desired word in the Looking For field. A default replacement suggestion will automatically appear in the Replace With field. You can either use this suggestion, or enter your custom replacement. Once you are ready, click the Add button. The newly added word will automatically appear in a list below as shown. NOTE: Keep in mind that this feature censors only the body text of a feed. The author’s name and avatar are not affected. Furthermore, only Facebook posts an d RSS feeds can be censored. Twitter feeds can’t be modified at all because of Twitter’s policy Facebook App To integrate SocialMediaBox with Facebook you need to add Facebook application. To do this, you should create a Facebook Developer Account first. The whole procedure is described in detail in our SocialMediaBox Setup Guide which you can download from our website at https://athensa.tv Type in application name. After you register as a Facebook developer, you obtain App ID number and App Secret code. Copy and Paste them in the corresponding fields and click Save. Now you can feed the channel with Facebook content. Twitter App To integrate SocialMediaBox with Twitter you should fill in the following form. Once you are registered as a Twitter developer, you are given the Consumer Key (API Key), the Consumer Secret (API Secret), the Access Token and the Access Token Secret. Copy and Paste them in the relevant fields and click Save. If you are unfamiliar with Twitter Developer Registration, download the SocialMediaBox Setup Guide, available at https://athensa.tv TIP: It is recommendatory to create a separate social media application for each TV channel in SocialMediaBox in order not to surpass the limit of maximum sessions in a channel CREATE TITLEBOX CONFIGURATION To define Create TitleBox Configuration: On the Settings Menu, click Manage System>TitleBox Management>Create TitleBox Configuration You can output SocialMediaBox feeds as on-screen graphics through TitleBox. You should create a custom TitleBox project, save it as a project template and feed the content from the SocialMediaBox list to particular objects from the project. If you are unfamiliar with creating template folders in TitleBox, refer to Appendix -1 in this guide. NOTE: Before you start setting the configuration, be aware that if the instances of SocialMediaBox and TitleBox are installed on different servers, they should share the same Microsoft account Enter a custom name of the TitleBox instance. Then enter the IP address and port number of the server where TitleBox is installed, the TitleBox channel ID (as in TitleBox: Project > Options >Network>NetControl) and the network path to the templates folder as in the following example: EDIT TITLEBOX CONFIGURATION To access Edit TitleBox Configuration: On the Settings Menu, click Manage System>TitleBox Management>Edit TitleBox Configuration In this table you can view and edit the existing TitleBox configurations in the system. Click the Edit button to edit the following fields: Name – To change a channel’s name, click on the corresponding field and type in the desired name; Description – This field is not required. However, you can either add or edit channel’s description information; IP – To edit the IP address where TitleBox is installed, click the corresponding field and enter the new IP address values; Port – To change the port number where TitleBox is installed, click on the corresponding field and enter the new port number; Channel ID – to reconfigure TitleBox channel ID, click on the corresponding field and enter the new channel ID; Template folder – To edit the path to TitleBox template folder, double-click to select the current path and enter the new one; Assign to TV Channel – In this last section you should assign the TitleBox configuration to one of the existing TV channels, listed below. Simply click on the desired TV channel. If you click on Do not assign option, the current TitleBox configuration will not to be active. CREATE USER ACCOUNT To access Create User Account: On the Settings Menu, click Manage System>User Accounts>Create User Account This feature allows easily adding users. Fill in the available fields with the corresponding information as follows: Username – enter a desired name; Full name – enter a desired full name; E-mail – fill in a corresponding e-mail address; Password – enter a password; Confirm Password – re-enter the password. Account State – select the state from the corresponding drop-down list. Blocked users cannot access the system. Since no user is removed from the system, you can activate a blocked user back at any time. Account Type - use this drop-down menu to switch a user's type from Regular User Account to User Account is SUPER ADMIN and vice versa. IMPORTANT: The difference between the two types is that the Super Administrator account has a full access to all available me nu settings (including the Manage System feature) and is able to operate within all TV channels in the system, while the Regular User Account has restricted rights. Once you are ready, click Create. The newly created user will be added to the list in Manage System>Edit User Account. Be aware that with one application you have many user accounts. EDIT USER ACOUNT To access Edit User Account: On the Settings Menu, click Manage System>User Accounts>Edit User Account In this page you can view and edit the existing user accounts in the system. By clicking the Edit button the following user settings can be edited - Full Name, E-mail, State and Account Type. Also, you can change the current password by using the corresponding fields – Reset Password and Confirm Password. APPENDIX 1 -Integration of SocialMediaBox with TitleBox To output SocialMediaBox feeds as on-screen graphics through TitleBox, you should setup a shared TitleBox templates folder and save your projects as templates. Then you should configure TitleBox Net Control and save templates. Configuration settings: To create and setup a TitleBox templates folder, proceed as follows: 1) Create a shared folder for TitleBox templates on the machine where TitleBox is installed NOTE: The template folder should be opened in shared mode in order to be accessible from different machines 2) Run Programs > PlayBox Technology Ltd. >TitleBox PLNetInst.exe 3) In the PLNET dialog, click Browse and navigate to the folder 4) The network folder path should begin with the IP address of the machine where TitleBox is installed. See the screenshot: 5) Add a backward slash “\” sign after the network folder path. 6) Click Next TitleBox settings: To configure TitleBox Net Control and save templates, do the following: 1) Create your TitleBox projects. 2) Export them via Network >Export project as template, giving them respective names 3) *.tmpl (template) files are exported in the templates folder. 4) Go to Project\Options , look at Network tab. Remember the TitleBox channel ID and Port values. Confirm any changes. 5) Go to Network>Net control . Run it. That's all for TitleBox. Now you are able to export SocialMediaBox feeds to TitleBox. Please, note that while performing the integration process, the TitleBox instance needs to be closed. NOTE: Keep in mind that one TitleBox instance is used per one TV channel in SocialMediaBox ATHENSA LLC 2970 Clairmont Road NE, Suite 640, Atlanta, Georgia 30329, USA Tel. +1 (404) 424 9283 Fax +1 (404) 835 1705 [email protected] https://athensa.tv All rights reserved copyright © 1999-2015