homesupportdrupal 7

changelog

v3.0.4 – september 2015
  • complete plugin package *note: requires drupal v7.x and php v5.3 or higher for video
    • don’t meet the minimum requirements download our previous versionhere
  • supports dynamic call to action for imported videos
  • supports module update notification
  • supports comprehensive error reporting and error logging
  • supports existing content types
v2.0 – may 2013
  • stable drupal 7 module.
    • not comprehensive –
      • limited support for brafton videos
      • no update capability
      • no error reporting

[jump to top]

installation
install_modules

to install the brafton module log into your administrator panel and click the “modules” menu item.

install_new_module

find the “install new module” link and follow the instructions to install a new module.

activate_module

you will now need to ensure that the newly installed module gets activated. scroll down to the section labeled “brafton content integrator” and check the box to the left of the module named “all in one brafton content integrator”. scroll down to the bottom of the page and click “save configuration”.

your module is now ready to use. to access your modules you can click the “configure” link to the far right or access the modules settings via the “configuration” menu item at the top. on the configuration screen you will see the “all in one brafton content integrator” listed under the “content authoring” section.

brafton_menu

[jump to top]

configuration

quick configuration:

  1. general options:
    • type of content : select articles.
    • api root : select the brand you are working with
    • content author : select your name
  2. article options:
    • api key : enter the api key provided to your by your account manager
    • (optional)check offcreate a news page at “mydomain.com/news”
  3. click“save configuration”at the bottom of the page
  4. run your sites cron or click“run article importer”under“manual control & archive uploads”to import your first articles.

[jump to top]

general options

this is a complete list of the options available complete with option explanations.

choose content types

  • type of content

    • articles : select this option ifonlyimporting articles (will require an api key)
    • videos : select this option ifonlyimporting videos (will require a public and private key)
    • both : select this option if receivingbothtypes of content
  • api root (we provide content for the below 3 brands. simply select which brand you are receiving your content from)

    • brafton
    • contentlead
    • castleford

import options

  • content author : select a single user to attribute your imported content to
    • **you may also select get author from article but only if you are receving the“byline”element in your feed. you may check with your account manager
  • import date
    • published date: import your articles usin the“published date”from your feedrecommended
    • created date: import your articles usin the“created date”from your feed
    • modified date: import your articles usin the“modified date”from your feed
  • enable comments: choose if you would like your audience to interact with your articles
  • overwrite any changes made to existing content : check this box to update your content from the feed
    • know that this will overwrite any and all changes you may have made through your cms. in addtion articles remain in your xml feed for only a period of 30 dayswill also download fresh copies of images since we are updating content. images are part of content
  • import content as unpublished : check this option to import your articles asunpublishedallowing you to review or change them before the public is able to view them.
    • leaving this unchecked will cause articles to appear on your public facing blog as soon as they are imported

article options

note that options here will apply toonlyarticles as videos have different settings below

  • api key : your unique key to access your xml feed of content

integration options for articles

  • create a news page at “mydomain.com/news” : this will create a url to access your blog by the public
    • it is recommended to set up a view instead if you have that capability
  • create archives pages at “mydomain.com/news/archive/year/month” and an archives block : creates a page to view your article archives as well as a block to use to display your archive links
  • create a categories block : creates a block to use to display the categories available for view
  • create a headlines block : creates a block best placed on your home page to display the latest articles
  • add related articles to brafton posts : adds the latest articles matching the current articles category to the bottom of the page.only works if using default content type
  • content type –for advanced usersallows you to import your articles as a pre-existing content type rather than the defaultnews articlescontent type created by this module
    • if you choose a pre-existing content type you will need to map your existing fields to the content
      • content of the article : this is the body of the article. select from the drop down the appropriate field for this content.
      • image for article : this is the featured image of the article. select from the drop down your image field for your content type.
      • taxonomy for article : this is the category selected for your article. select the taxonomy field for your content type.

video options

note that options here will apply toonlyvideos as articles have different settings above

  • video public key : your public key provided by your account manager
  • video secret key : your private/secret key provided by your account manager
  • video feed number : your video feed id numberleave this set to 0 unless you have more than one video feed

integration options for videos

  • create a video page at “mydomain.com/videos” : this will create a url to access your video blog by the public
    • it is recommended to set up a view instead if you have that capability
  • create video archives pages at “mydomain.com/videos/archive/year/month” and an archives block : creates a page to view your video archives as well as a block to use to display your video archive links
  • create a video categories block : creates a block to use to display the categories available for view
  • create a video headlines block : creates a block best placed on your home page to display the latest videos
  • add related videos to brafton posts : adds the latest videos matching the current video category to the bottom of the page.

brafton video cta’s**

  • use video cta’s : check this option if you would like to take advantage of our custom call to actions.
  • atlantis pause cta text : text appearing at the top of the video when the pause button is pressed
  • atlantis pause link : url to send visitors to when they click theatlantis pause cta text
  • pause asset gateway id : arch id of your pop up formrequires your enrollment in arch. see your account manager for details.overrides pause link
  • atlantis end cta title : the text appearing near the top of the video once it has finished playing.
  • atlantis end cta subtitle : text just below the title appearing in slightly smaller font at the end of the videos
  • atlantis end cta link : url to send visitors to when they click theatlantis end cta text or ending cta button image
  • end asset gateway id : arch id of your pop up formrequires your enrollment in arc. see your account manager for details.overrides end cta link
  • atlantis end cta text : clickable text at the end of your video sending visitors to youratlantis end cta link
  • ending cta button image : the image you wish to use instead of theatlantis end cta text
  • ending button image placement : select the position of your buttonnote: select a positon that doesn’t interfere with your other elementsyou can also further affect the position with css
    • top left
    • top right
    • bottom left
    • bottom right
  • ending background image : you may select a background image to use at the end of your video to provide further branding.

brafton error reporting

  • error report : provides a detailed list of errors that occur during the import process. only errors that report in a failure to import content will be logged automatically. if such an error occurs debug mode is turned on.
  • debug mode : check the box to catchallerrors regardless of severity. this option is turned on automatically if avitalerror is detected.
  • clear the error report log : clear the current list of errors.

manual control & archive uploads

  • run article importer : allows you to run the article importer on demand
  • run video importer : allows you to run the video importer on demand
  • run archive importer :only shows after uploading archiveallows you to import your provided archive.
  • article archive file : uploads your archive of content no longer on the live feed so you may import that content.