homesupportdotnetnuke 7+ module

brafton module

*note: be sure to select the blog module for your installation of dnn

dnn blog module(dnn version 7) version 6.2.2

dnn blog module(dnn version 8) version 6.3

changelog

v3.01 .02 june 2017
  • full release candidate:
  • atlantisjs protocol change to https
  • v3.01 .01 february 2016
    • rebuild new beta release compatible with dnn version 7 and dnn blog module 6+
    • added error reporting
    • added update notification
    • custom video cta’s
      • support for arch pop ups
    • ability to use the module on multiple dnn pages

[jump to top]

module requirements

  • dotnetnuke 7.2+
  • dotnetnuke blog module 6+ (note: dnn version 8 requires blog module 6.3 however dnn version 7 requires blog module 6.2.2)
    • this module works with the dnn blog module. the brafton content importer module imports content from our api feed into your installation of dnn utilizing the dnn blog module capabilities. the dnn blog module handles modification and display of the content once it is imported.

[jump to top]

installation & setup

  • under the host tab, navigate to the extensions menu item.
  • note: you must first have installed the dnn blog module.
  • using the “install extension wizard”, you can upload and install our module as you normally would.
  • you will now see the brafton content importer installed.

dnn, by default, will strip out and not allow certain html elements in your content when editing, modifying, or displaying posts in any way. you must first disable this feature to allow html elements in your posts

  • navigate to the host tab
  • select the html editor manager
  • dnn provides you with a default “radeditorprovider” for editing your content. if this is the editor you are using follow the instructions below. if you are using a different editor, consult your editor’s documentation for instructions on how to ensure html tags (such as iframe, div, script, input) can be used in your content via the editor.
  • on the left hand side, select “everyone” under default configuration.
  • select the “editor configuration” tab
  • under edit modes, ensure all 3 options (design, html, and preview) are selected.
  • ensure “remove scripts” has been deselected and “encodescripts” has been selected.
  • be sure to click update at the bottom of the page.

[jump to top]

configuration

  • navigate to the page where you will be putting your blogs, or create a new page.
  • under “modules->add new module” at the top, find the “blog” module and add that to the page.
  • setup your blog module and ensure you complete the following
  • under the “manage” tab, add a blog.
  • you must now add a category term to populate the dnn blog module term vocabulary under the “category” tab.
    • note: this category will not be used, however an initial entry must be made for brafton categories to import properly. we recommend either “first entry” or “setup” to easily identify it for deletion later.
  • you may set the remaining settings any way you choose.
  • under “modules->add new module” at the top, find brafton content importer and add this module underneath the blog module.

[jump to top]

importer settings

all settings for the importer are located in the module settings section, accessible via the “sprocket” icon. once you bring up the settings page, click the “brafton content importer” tab to configure your importer.

  • import my: select what type of media you will be receiving.
    1. note: you may setup the module on different pages and import your article and videos to separate blogs.
  • select your blog: select the blog you want to import your content into. this blog must appear on the same page as the module.
  • api domain: select your brand domain, either brafton, contentlead, or castleford
  • your api key: this is your api key, provided to you by your account manager.
  • author of blog posts: set up the author to attribute your posts to.
  • featured image:

the dnn blog module has built in features to handle images. depending solely on the templates used by your theme and the options chosen when setting up the blog module, you may want to allow the dnn blog module to handle the images.

if do not want to use the functionality of the blog module to display your images, you may have the content importer insert the image into the body and summary of your article. this is done by inserting a div container that can be styled using vanilla css rules.

note: you may change this later. however, depending on when the content was originally imported, and the type of content, these changes may affect previous articles.

  • update existing content: turning this setting to “yes” will update any previously imported articles within the past 30 days or the last 30 videos imported, regardless of date imported, with the copies on your api feeds.
  • importer debug mode: turning this feature to “on” will aid in the diagnosis or any issues or errors that are are preventing your content from importing.

video settings

you will only need to fill this section out if you selected “videos” or “both” under “import my:”

  • your public key: your public key, provided to you by your account manager
  • your private key: your private key provided to you by your account manager
    1. note: your private key and your api key may look extremely similar, however these are not the same key.
  • your feed id: this is usually 0(zero), but if you have multiple video feeds you will need to contacttechsupport@brafton.comfor assistance.
  • include jquery: atlantisjs (our video player) requires jquery to function. enabling this option will add jquery to your article pages.
  • include atlantisjs player: atlantisjs is a video player that uses html5 and videojs to play videos on your site and provides the functionality for pause and end of video cta’s. if you wish to use this player you will need to turn this option on. if this option is left off whatever video player the users browser has by default will be used if one exists.
  • video pause message: enter a message that will appear overlaid at the top of the video when the pause button is pressed
  • video pause cta url: enter a valid url for a user to navigate to when they click your “video pause message”
  • pause arch id: enter the arch id provided by your account manager. this will be the id of the form you wish to use in place of a url
  • end of video title: enter a title that will appear overlaid at the top of the video at the end of playback
  • end of video subtitle: enter a subtitle that will appear overlaid under the title at the end of playback
  • end of video button text: enter a call to action button text that will appear as a button to be clicked. note: this should be short (eg: click here, subscribe, get more information etc.)
  • end of video cta url: enter a valid url for a user to navigate to when they click your “end of video button”
  • ending arch id: enter the arch id provided your account manager. this will be the id of the form you wish to use in place of a url

once you have filled out all the necessary fields be sure to click “update”.

ensure that you have no errors or warnings under “status”. if you have any messages, you must correct them before the “import content” and “enable automatic import” buttons will be enabled.

once you receive a green check status, you may click the “import content” button to initiate your importer for the current page. a status bar will appear to indicate the importer is functioning.

you will receive messages indicating a success or failure of operations.

you may now “enable automatic import”, which will run the importer using the dnn scheduler on an hourly basis.

support

  • brafton can provide support if content is not importing into your installation; however, we can only provide limited support for setting up templates for displaying the content via the blog module.

[jump to top]