=== GrabPress === Contributors: grabmedia Tags: video, grab, grabpress, grab media, grab-media, grab networks, rhythm one, rhythmone, rhythm new media, burst media, pre-roll, video catalog, media, video feed, video player, HTML5 video, video content, professional video, premium video, advertising, syndication, ad units, video widgets Requires at least: 3.7.1 Tested up to: 4.1.1 Stable tag: 3.0.3 License: GPL2 License URI: http://www.gnu.org/licenses/gpl-2.0.html Configure GrabPress feeds to deliver fresh videos for your blog. == Description == GrabPress from Grab Media, is a plugin that delivers content from our extensive premium video catalog to WordPress sites. GrabPress enables editors to publish high-quality video content within their WordPress blogs, making our video catalog more accessible to publishers and editors. GrabPress enables editors to create video feeds customized to deliver content relevant to their audiences and editorial interests. These video feeds are defined by entering simple search criteria, which may include keywords, video categories, and Content Providers. As new videos are added to the Grab Media video syndication platform, the catalog service continuously matches videos (metatdata) to the search criteria for each video feed, and updates the feeds with fresh content. Editors are able to browse, watch and select videos from their feeds to post on their sites. Though older versions of GrabPress allowed editors to automatically post new videos that were added to their feeds, editors are now encouraged to select videos from their feeds to customize their video posts. Editing the new posts created by GrabPress will ensure that videos are featured uniquely on each publisher site. This significantly improves search engine optimization, it increases the value proposition for advertisers, and most importantly Рit drives user engagement and revenue for your site. GrabPress reduces the time publishers need to spend on searching, editing, and developing new content, while providing an intelligent stream of videos their site. In addition to providing workflow automation tools and continuous access to new premium videos, GrabPress enables publishers to monetize their video views. Once a WordPress site is linked to a new or existing Grab Media account, GrabPress revenue data can be accessed from our reporting dashboard on grab-media.com. For additional documentation, contact your account manager or email us at support@grab-media.com for more assistance. www.grab-media.com == Frequently Asked Questions == **Getting Started...** = How do I set up an account with Grab Media? = After installing the plug-in, select Settings > GrabPress from the WordPress Admin menu. This will give users the option to create a new account with Grab Media, or to link an existing Grab Media publisher account. = I already have an account with Grab Media, how do I tie my existing account to Grab Press? = Same as above--after installing the plug-in, navigate to the Settings > GrabPress page in your WordPress Admin. This will bring up the option to create a new account with Grab Media, or to link an existing account with us. = How do I check my statistics? = Go to Grab-Media.com and click the Login button in the header. Login with the same email (username) and password credentials you generated when you registered for a Grab Media account to access the Publisher Reporting Portal. = I would like to get more data than the report portal provides. How can I get that? = Grab can provide you automated, daily data exports that enable you to perform your own performance analyses. Contact us and we can provide your specific reporting or data request. **Creating Video Posting Feeds** = I have installed the plug-in and set up my Grab Media account. Now what? = Once GrabPress is installed you should be prompted to set up your first video feed, by supplying search criteria relevant to your audience or site (or section of your site). When these steps are completed you can add additional feeds or begin browsing your feeds to select videos for your blog posts. = Why don't I see any videos in the preview? = If you don't see any videos populating in your video feed preview, we most likely don't have any videos that match the criteria you specified in your search. We recommend that you broaden your search criteria, and test various search settings until the feed preview displays enough assets to meet the needs of your editorial workflow. Note that when you enter keywords for your feed, you can select to require all keyword terms using keywords AND, or you can select keywords OR, which will deliver videos that have any of the keywords you enter. = Why are my video feeds not updating every day, or every week? = If you notice a video feed has not been updated with a new video in an extended period of time, you should select the feed from the Video Feeds > Manage Feeds screen, and click the edit icon to broaden your search criteria and re-save the feed. Some video feeds update every hour, some update every day, and others update less frequently. The frequency at which a feed gets updated depends on the specificity of a feed's search criteria, as well as the rate at which our Content Providers (who provide videos specific to your feed's search settings) add new content to our video inventory. Some of our Content Providers add new videos to our catalog multiple times a day, and others add content to the video catalog less frequently. = Can I edit or delete feeds I have created? = Once a feed is created it is displayed in the Video Feeds > Manage Feeds screen. To delete a feed, click delete "x" icon next to the feed criteria. To edit, click the edit icon in that feed listing. This will repopulate the corresponding fields in the Video Feeds > Create Feed screen, where you can modify and save your feed. = Why do I need an account with Grab Media? = Creating or linking an account allows us to keep track of your players, so we can make sure you get paid. When you link your account to GrabPress, we associate the embed IDs from your video posts to your Grab Media publisher account. Once your embed IDs are linked to your publisher account, each impression it creates can generate revenue for your site. **General Questions** = Why is there a tabbed index for GrabPress in my site dashboard? = GrabPress is built to scale. That means we have many more features and ways of delivering monetized video intended for the future. This includes, but is not limited to, post promotion, template layout editing, video widgets, email notifications, and custom ad units. As features such as these become available through future GrabPress updates, they will appear as additional tabs within GrabPress. = How do I uninstall GrabPress? = Go to the plugins section of your site and select uninstall under the GrabPress plugin. Uninstalling will delete your API key as well the data associated with your GrabPress instance. All feeds, feed settings, and account info will need to be recreated if GrabPress is subsequently installed again. = Can I adjust the format posts are sent in? = Currently there is no way for the user to adjust the post layout via the GrabPress plug-in. We plan to enable users to edit the layout / posting template in future updates of the plugin. = What is the difference between auto-play and click-to-play? = Selecting auto-play means videos will automatically start playing when a user opens the page the video is on. Selecting click-to-play means a user will have to click the video to start it. This can be ideal for manually edited posts, when you want users to engage with the video at some point after engaging with the article content. = Why should I use GrabPress to deliver video to my blog? = GrabPress automates delivery of topical content to your site Рcutting down on the effort needed to search for video content for your site, as well as the need to optimize your site for revenue potential. GrabPress also allows editors to keep their sites up to date with trending and hot news topics by delivering monetized video posts that are relevant to the your site's topics. It enables editorial teams of all sizes to keep their audiences informed with ongoing news, gossip, and highlights in the media. **Permissions** = Do all users see the same information in my GrabPress installation? = No. GrabPress leverages the user roles already in place within WordPress. In order to make sure you have all necessary functions available to you through GrabPress please set your user roles in your dashboard as needed. = What does each user role enable me to do through GrabPress? = All user roles are able to search our catalog for a video and create a video post. Additionally, editors have the ability to create, manage and select videos from the Video Feeds page. They also have the ability to edit the template options for the size of the embed. Editors have access to all functions and tabs, excluding the Grab Media account Settings (WordPress Settings > GrabPress). Finally, as an Administrator, all functions and tabs, including the GrabPress settings, are available at all times. Once GrabPress is installed, the Administrator should link the instance to their Grab Media account through the account tab, as no other user is able to link accounts. = Can I set authors to be able to edit feeds or edit my account information? = To adjust what a user is able to do in GrabPress you must change their WordPress user role to enable the required functions. = As an editor, am I safe to link on a website with multiple editors? = Yes. Leveraging user role permissions will keep your install brand safe, allowing you to link your account and manage feeds without concern that these settings will be changed by someone with a less powerful user role, such as author, accidentally. = Can all users still view and post articles delivered through GrabPress? = Yes. All users can view the GrabPress dashboard to stay aware of editorial changes, and edit any post they have access to through the WordPress dashboard. = Can authors see my account information? = No. All users are provided pertinent information for debugging and support purposes, such as user email and API key. However, these users are not given access to personal the information associated with your account. == Screenshots == 1. Create video feeds that are customized to your audience and blog. 2. Quickly view videos and feed status on the Dashboard. 3. Publish a video post to your blog. 4. Create a publisher account to link you embeds, so you can get paid! 5. Search for videos directly in your WordPress post editor. 6. Manage and preview your saved video feeds. 7. Select a video to post from your saved video feeds. == Changelog == = 3.0.3 = *Bug Fixes:* * GBPS-645 Continued - Published video posts are not showing any videos * GBPS-654 Request embed_ids only once, and store then locally to reduce network traffic * GBPS-651 Handle the situation when no defaults embed ids are created (installation or upgrade) = 3.0.2 = *Bug Fixes:* * GBPS-649 Embed ID is missing from the embed script in published posts from older versions of the plugin, preventing video players from rendering = 3.0.1 = *Bug Fixes:* * GBPS-642 Published video posts are not showing any videos for old Autoposter posts = 3.0.0 = *Features:* * GBPS-476 As a publisher, I need all v2.4 Jetpack and WordPress connection setup steps removed from the WordPress settings GrabPress page * GBPS-478 As a publisher, I want to navigate GrabPress with Video Feeds page, instead of Autoposter * GBPS-479 As a publisher, I want my GrabPress dashboard to show information about my Catalog API feeds * GBPS-480 As a publisher, I want to be able to browse my feeds and create a post from the 'Select a Video From Feeds' tab in the Video Feeds Page * GBPS-481 As a publisher, I want to create a video feed (catalog playlist) so I may easily retrieve search results * GBPS-483 As a publisher, I want to save my WordPress instance info using the Auth API instead of the Autoposter API, and ask the user for permission * GBPS-541 As a publisher, I want to create a post from a video in my Video Feeds * GBPS-540 As a publisher, I want to manage my video feeds, so I may update and delete them as necessary *Improvements:* * GBPS-477 Remove messages regarding Autoposter settings, connectors and APIs * GBPS-487 Use grab Auth API for user CrUD instead of Autoposter API * GBPS-489 API switch Endpoints: Refactor related functions to have CRUD operations with Video Feeds * GBPS-488 Remove connector related code from Grabpress * GBPS-559 Remove all Autoposter and Jetpack related functions from the GrabPress plugin *Bug Fixes:* * GBPS-217 Replace event.returnValue with event.preventDefault() to avoid warning messages on each page * GBPS-315 Autoposter Tab: Fix type in feeds creation success message = 2.4.0 = *Features:* * GBPS-23 - As a WordPress VIP plugin, GrabPress/AutoPoster needs to use the WP REST API and WP OAuth instead of using XML-RPC and creating a 'grabpress' user * GBPS-89 - Send a new message to users who have not created an Autoposter connection * GBPS-112 - Send WordPress Oauth token to Autoposter when creating a connector * GBPS-116 - Hide the Template tab in left navigation until an Autoposter connector has been established * GBPS-219 - As a WPVIP plugin, I need to make sure to send AP a notification to set all feeds to inactive when I'm deactivated * GBPS-221 - As a WPVIP plugin, I need to implement WordPress OAuth handshake and authenticate all users through it * GBPS-227 - As an Autoposter User, I'd like my autoposts to use my provided credentials * GBPS-239 - As a user, I want to create my Autoposter connector and authenticate (WP API + Oauth) from a link in the Autoposter tab * GBPS-247 - Add environment parameters for Oauth app to host on grab-media.com *Bug Fixes:* * GBPS-198 - Dashboard Watchlist: Player is not displaying correctly in Firefox (Prod & QA) * GBPS-213 - In catalog page, it caused php warning after search * GBPS-243 - Template tag format issue is causing preview image + video to appear on the same page = 2.3.7 = *Features:* * GBPS-7 - All forms need to have proper validation across the plugin * GBPS-172 - Edit feed: There should be a option to deactivate the feed * GBPS-215 - Dashboard UI improvement - Feed Activity - turning on/off feeds in Watchlist *Bug Fixes:* * GBPS-206 - Fortune Cookie messages are displaying inline HTML code * GBPS-203 - Edit feed: User is not able to use the existing keyword (used for some other feed) and update the feed * GBPS-195 - Accounts > Create and link to new account > Clear form is not working * GBPS-194 - Dashboard: Feed details page: Improvements, time format and typo errors * GBPS-192 - IE10 > Dashboard: Watchlist Video title overlaps with player progress bar * GBPS-188 - Template Page: Player minimum width should be 400 px, max width should be 1200 px * GBPS-186 - Edit feeds: When we update an existing feed, we get the message 'Feed created successfully�' * GBPS-185 - Post author drop down value is empty if we try to create a feed from catalog page * GBPS-182 - Update 'grabpress' user password if user uninstalls/reinstalls GrabPress * GBPS-179 - Catalog page: Enter Keyword > Search > Create feed > should populate search criteria to Autoposter create feed form * GBPS-177 - Dashboard: Watchlist > Not able to watch all videos * GBPS-176 - Dashboard: Contents are not displayed after un-linking the account * GBPS-168 - Edit feed: Clicking cancel editing after doing some changes is not working * GBPS-166 - IE 9/IE 10: Clicking preview from create feeds page causes JS errors * GBPS-165 - Autoposter Page - display for categories differs from 1st save and subsequent (edit feed) saves * GBPS-164 - Template page: Height value is not changed upon switching between widescreen 16:9 and standard 4:3 * GBPS-161 - All the pages: Information message display issues * GBPS-160 - Manage feeds > Post category value is incorrectly displayed * GBPS-146 - IE9 > Dashboard > Watch list panel is truncated on page load * GBPS-127 - PHP errors generated when GrabPress is calling its own functions * GBPS-90 - Update the get_providers() method to include the API_KEY * GBPS-73 - IE 8: Having a feed in the Dashboard Watchlist renders an error * GBPS-30 - Dashboard > Watchlist: Only the first video selected plays = 2.3.6 = *Bug Fixes:* * GBPS-90 - Update the get_providers() method to include the API_KEY * GBPS-159 - Message is misplaced when saving a feed * GBPS-163 - Catalog page: Clicking clear dates button is not clearing the 'To' field value. * GBPS-164 - Template page: Height value is not changed upon switching between Widescreen 16:9 and standard 4:3 * GBPS-165 - Autoposter Page - display for categories differs from 1st save and subsequent (edit feed) saves * GBPS-168 - Edit feed: Clicking cancel editing after doing some changes is not working * GBPS-176 - Dashboard: Contents are not displayed after un-linking the account * GBPS-177 - Dashboard: Watchlist > Not able to watch all videos * GBPS-179 - Catalog page: Enter Keyword > Search > Create feed > should populate search criteria to Autoposter create feed form * GBPS-182 - Update 'grabpress' user password if user uninstalls/reinstalls GrabPress * GBPS-188 - Template Page: Player minimum width should be 400 px, max width should be 1200 px * GBPS-192 - IE10 > Dashboard: Watchlist Video title overlaps with player progress bar = 2.3.5 = *Features:* * GBPS-4: Ensure all features are compatible with WordPress v3.6 * GBPS-5: As a WordPress VIP user, I want to use GrabPress for video content on my site *Bug Fixes:* * GBPS-6: All values returned from the Autoposter, Catalog, and WordPress APIs need to have all special characters escaped * GBPS-8: Thumbnail download and insertion should use more of the WordPress API to prevent bugs and compatibility issues on WordPress.com * GBPS-9: ALL URI paths to the plugin should use the plugins_url function to resolve properly across the platform * GBPS-10: Ensure that unused files are not being loaded * GBPS-11: Verify that the correct WordPress API hooks are used across the plugin * GBPS-12: Eliminate loading of any unused JavaScript files and code * GBPS-13: Verify that all prefixes for page slugs, Ajax actions, and the like are in place * GBPS-14: Script tags should not be enabled with TinyMCE * GBPS-15: All AJAX callbacks need to have proper capability and nonce checks * GBPS-16: Ensure that all calls to register_settings have a sanitize_callback to clean up the data before it's saved * GBPS-17: Remove GrabPress::allow_tags and GrabPress:: mce_settings * GBPS-18: Remove methods/API calls that are not allowed in WordPress VIP: get_wordpress_plugins and report_versions * GBPS-19: Any methods using the 'curl', 'file_get_contents' and 'GrabPressAPI' need to be changed to use the WordPress HTTP API * GBPS-21: All AJAX callbacks need to properly sanitize the REQUEST data passed in * GBPS-22: Remove methods/API calls that are not allowed in WordPress VIP: enable_xmlrpc * GBPS-29: Support for the minimum version of PHP required by WordPress * GBPS-62: Create post button on catalog page is not working * GBPS-63: Unable to watch videos in the Catalog search results screen * GBPS-65: There is no way to close the preview window in the Autoposter screen * GBPS-74: As a WP VIP user, I want all my plugins to adhere to WordPress Coding Standards * GBPS-78: Make GrabPress adhere to all WordPress HTML Coding Standards * GBPS-79: Make GrabPress adhere to all WordPress CSS Coding Standards * GBPS-80: Make GrabPress adhere to all WordPress JS Coding Standards * GBPS-117: Verify GrabPress works with WordPress 3.7.1 * GBPS-123: As a user, I need the AutoPoster API key deleted from my WordPress instance database when I delete the GrabPress plugin from my WP Admin plugin manager * GBPS-126: Unable to save feed on Autoposter page * GBPS-129: Unable to link Grab Media Publisher Account on Account Tab * GBPS-133: Unable to unlink the existing account * GBPS-134: Manage feeds: Preview button is not functional * GBPS-138: Edit feed page: Post author drop down values which were displayed during create feeds becomes blank during edit mode * GBPS-139: In preview feed popup window, Close(X) button is partially truncated/not accessible * GBPS-149: Catalog > Create Post button does not take use to the Edit Post page (with selected video) * GBPS-152: Posts > Insert Into Post is not working = 2.3.4 = *Features:* * AUTO-899: As a WordPress Publisher, I want to be alerted when any of feeds have produced an error, so they can be resolved. * AUTO-898: As a GrabPress user, I want to provide a list of tags for each feed I create so the feed-specific tags will apply to all posts for that feed * AUTO-897: As a WordPress Publisher, I want to provide a list of tags to exclude from my feed, so my tag library is not bombarded. * AUTO-835: As a WordPress Publisher, I want to be notified if I'm not using the current version of the GrabPress Plug-in, so I know when I need to update my plugin. * Various UI/UX tweaks *Bug Fixes:* * AUTO-880: Spacing between pagination link and first video increases after using pagination. * AUTO-694: Watchlist rolled-over titles have unaesthetically pleasing tooltips. * AUTO-559: Secondary mouse button works as primary in the manage feeds section. = 2.3.3 = *Features:* * AUTO-833: As a WordPress Publisher, I want the duration displayed for all videos in the Catalog and AutoPoster tabs, so that I can determine if I want to use a particular video or not. * AUTO-831: As a WordPress Publisher, when creating a feed I want to perform all search functions on the AutoPoster page, instead of having redundant search options on the preview page. * AUTO-791: As a WordPress publisher, I want my keywords emphasized in the video descriptions, so that I know why videos are returned in the result set. * Various UI/UX tweaks = 2.3.2 = * AUTO-660: As a WordPress Publisher, I want the player in the dashboard to be visible between a minimum of 320px and a maximum of 640px width. * AUTO-802: As a Grab Media Developer, I want to know more about our user environments, so we can better develop, test and debug against user environments. * Added support for PHP 5.2.4 call DateTime::modify, replacing DateTime::sub (The DateTime::Sub() error should no longer appear). * Addes support for PHP 5.2.4 call to check if PHP is configured with MagicQuotes for json_encode() call. = 2.3.1.1 = * Turned debugging off by default. (Thanks goes to @optimalpatrick) = 2.3.1 = *Features:* * AUTO-571: As a WordPress Publisher, I want to be warned when I create a feed that uses a keyword that has already been used in an existing feed. * Various bug fixes = 2.3.0 = *Features:* * AUTO-665: As a WordPress Publisher, I want to page through the search results from a search when inserting into a post, so that I have more results to view. * AUTO-654: As a WordPress Publisher, I want to click on a link in the Feed Activity section of the Dashboard, so that I may see each feeds settings and configuration information. * AUTO-652: As a WordPress Administrator, I want to limit access to creating feeds in the Catalog tab to WP users/roles with 'edit_others_posts' AND 'publish_posts' capabilities, so that only editors may create feeds. * AUTO-651: As a WordPress Administrator, I want to limit access to the Template tab to users/roles with the 'edit_others_posts' capability, so others cannot change my template settings. * AUTO-650: As a WordPress Administrator, I want to limit access to the Autoposter tab to WP users/roles with 'edit_others_posts' AND 'publish_posts' capabilities, so that only editors may create/edit feeds. * AUTO-649: As a WordPress Administrator, I want to limit access to the Account tab to WP users/roles with 'edit_plugins' capabilities, so that only administrators may link my grabpress instance to a GrabMedia account. * AUTO-641: As a WordPress Publisher, I want to page through the search results from a search on the catalog tab, so that I have more results to view. * AUTO-607: As a WordPress Editor, I want to see a rollover treatment on the Title in the watchlist, so I know I can click on it. *Bug Fixes:* * AUTO-685: Posts created from the catalog tab are using the thumbnail image as the featured image, and in the posting, instead of the preview image. * AUTO-684: Selected categories and providers are reset to "ALL" after running a search on the catalog tab. * AUTO-648: Shortcode is using the click-to-play embed_id value for posts made from a feed that are set to use the autoplay embed_id. = 2.2.2 = * Various bux fixes. = 2.2.1 = * Introducing: The GrabPress shortcode! * Various fixes for wordpress.com VIP compatibility. = 2.2.0 = * Introducing: The Dashboard Tab! = 2.1.1 = * Fixed an issue with not using the correct embed_id. = 2.1.0 = *Features:* * AUTO-436: Add support for WordPress version 3.5. * AUTO-492: Re-enable "Insert into Post" functionality (AUTO-371). * Various bug fixes. = 2.0.4 = *Features:* * AUTO-401: Creating a post from the catalog tab will add the video keywords to the tags of the post. * AUTO-434: As a WordPress Editor, I want the preview image of the video to be used as the Featured Image of my post, when creating a post via AutoPoster or through the Catalog Tab. * AUTO-447: As a Product Owner, I want to track the WordPress version of each GrabPress installation. * AUTO-448: As a Product Ownver, I want to track the GrabPress version of each installation. * AUTO-465: As a publisher, I want to set the default width and height for all player embeds, so I can better control the look and feel of my site. * AUTO-480: As a WordPress Plug-in Developer, I want to use the version of JQueryUI packaged with WordPress. = 2.0.3 = * Removed feature to insert video while creating a new post, as it was breaking core WordPress functionality. = 2.0.2 = * Hot fix for an issue with player environments = 2.0.1 = *Features:* * AUTO-361: As the product owner of GrabPress, I want to track when publishers register GrabPress, in our CRM. * AUTO-371: As an editor, I want to execute a simple or advanced search against the Grab-Media Catalog, from the Create Post page, so I can insert a video into my post. * AUTO-382: As an editor, I want to sort my search results by relevance and date. * AUTO-384: As an editor, I want the title of the video to populate the post's title, when I create a new post from the Catalog tab. * AUTO-410: As a GrabPress user, I want the option to set up my feed with a schedule of AutoPosting every 6 hours. * AUTO-417: As an editor, I want postings from the catalog tab to include the same elements as AutoPosted content. * AUTO-418: As a WordPress publisher, I want the embed from all single posts to use Grab's JavaScript embed, so the video appears on mobile devices. = 2.0.0 = *Features:* * AUTO-334: As a publisher, I want the embed in auto-posted content to use Grab's JavaScript embed, so the video appears on mobile devices. * AUTO-249: As an editor, I want to execute a simple or advanced search against the Grab-Media Catalog, to find relevant videos for a post. * AUTO-250: As a WordPress publisher, I want to post a single video to my blog from the Video Catalog search results page. * AUTO-252: As an editor, I want to save my search results as a new feed using a 'Save as Feed' button on the Video Catalog page. *Bug Fixes:* * AUTO-408: When I create a feed using a category with spaces, I do not revieve any posts. * AUTO-405: After installing the GrabPress plug-in, my media tab from the admin menu disappears.