Jump to: navigation, search

Umlaut partial html API javascript helper

6,516 bytes added, 16:22, 19 June 2012
no edit summary
Hey=WARNING: This is Outdated Documentation! Great Stuff!, !!= '''THIS IS OUTDATED DOCUMENTATION''' See new Umlaut documentation at free porn picsteam-umlaut/umlaut/wiki--------- THE CODE DOCUMENTED HERE IS DEPRECATED. PLEASE SEE INSTEAD: [[JQuery HTML Updater]] If you want to include [[Umlaut]]-generated HTML directly on a third party page via javascript, there is a javascript helper script to make that very easy. This helper uses the [[Umlaut partial html API]], but does everything for you. 8The helper will update your divs, and keep polling Umlaut for new results, continuing to re-DDDupdate your divs until Umlaut is finished. How often it polls is configured by application config 'poll_wait_seconds', which defaults to 4 seconds.  == Overview == Your page needs to include the JS Prototype library. Currently, automatic inclusion of the Prototype library isn't working, so you'll need to include a <script> line to do so. You can link to the prototype library in Umlaut, see example below.  You will then include an Umlaut javascript file, and then call the embedUmlaut() js function it supplies. You'll need to pass some arguments to embedUmlaut:  === Umlaut base URL === The first argument is your Umlaut base URL. This is not your link resolver base url which for Umlaut ends in /resolve, but the actual Umlaut application base URL, which should be the same, without the /resolve. (Link to JHU example removed, because i think it was attracting malicious bot/spider traffic) === Context object === The second argument is a URL-formatted (KEV) [[OpenURL]] context object. === Display section mappings === The third argument is a javascript hash providing mappings from Umlaut html sections to HTML divs on your page. Umlaut html sections are configured in Umlaut in the "partial_html_map" configuration param, which by default is set to the "bg_update_map" config params :divs key. To see the sections in a default Umlaut installation, see: AppConfig::Base.bg_update_map [http://wwwumlaut.beborubyforge.comorg/ReynaC414 free black pornsvn/trunk/config/initializers/umlaut/resolve_views.rb in resolve_views in svn]. The :divs key of the hash there is an array of hashes, 8-each individual hash has a :div_id key that corresponds to the html_sections id in this api response. For Umlaut developers, the :partial key tells you what [[Rails]] partial is used to generate this section.  This mapping hash can also optionally use some javascript callbacks to perform behavior after or during loading of a particular section. In the following example, we'll demo using a javascript callback to only show a div for search_inside functionality if there are search_inside tools provided.  === General options === The fourth argument is a hash of additional options to embedUmlaut.  === Other Details === The umlaut_embed.js script will check if the javascript Prototype library is loaded into the host page, and load it if not. Among other things, this means you can use Prototype in your callbacks.  The html loaded will sometimes include a "spinner" with a message "loading more", if the content is not yet loaded.  An example is best: == Example == <pre>  <H1>Here is an article page. </h1>  <p>We're looking up Cytoplasmic Control of nuclear behavior by Masui. Of course normally this would be dynamically generated, not in static html like this.<p>  <!-- umlaut full text will be loaded here. You might want to include some initial content here for browsers without javascript. For browsers with javascript, this will be overwritten.--> <div id="my_fulltext"> <a href="http://wwwumlaut.bebouniversity.comedu/StormyG9 free porn thumbsresolve?url_ver=Z39.88-2004&rft_val_fmt=info:ofi/fmt:kev:mtx:journal&rft_id=info:doi/10.1002/jez.1401770202&rfr_id=info:sid/"> Link to umlaut </a> </div>  <!-- we hide this div to start out with, our js callback later will show it there is full text. But we avoid a "spinner" showing up here before everything is fully loaded. yqg--> <div id="my_search_inside" style="display:none;"></div>  <div id="my_cover"></div>  <div id="my_see_also"</div>  <div id="my_excerpts"></div>  <!-- now the javascript to actually load content in those divs -->  <script type="text/javascript"> // You have to generate an OpenURL context object somehow. // Normally this would be generated dynamically, not static HTML like this, of course. // You may want to include a rfr_id to identify your application as a source, demo below.   umlaut_openurl_kev_co = 'url_ver=Z39.88-2004&rft_val_fmt=info:ofi/fmt:kev:mtx:journal&rft_id=info:doi/10.1002/jez.1401770202&rfr_id=info:sid/';  // where to find umlaut umlaut_base = 'http://wwwumlaut.bebouniversity.comedu';  /ChristalA2 free amature porn/ Map of umlaut section id to: div id we want to put it on the page // Note the js call back for search_inside_wrapper, pdsxfto only show the // div on our page if there are elements. Js callback function gets one // argument, which will be number of Umlaut responses in the section. // Note also that we can use Prototype in the callback.   umlaut_section_map = { 'fulltext': 'my_fulltext', 'highlighted_links': 'my_see_also', 'excerpts': 'my_excerpts', 'cover_image': 'my_cover', 'search_inside': {'host_div_id': 'my_search_inside', 'after_update': function(count) { if ( count > 0) { $('my_search_inside').show(); } } } };  //global embedUmlaut options //demonstrate putting up an alert when Umlaut is done loading all content, which you //wouldn't want to do, but anyway. umlaut_options = { 'all-complete-callback': function() { alert('All done!'); } }; </script>  <!-- include the prototype library --> <script type="text/javascript" src="http://wwwumlaut.bebouniversity.comedu/VeraT771 download free pornjavascripts/prototype.js"></script>   <!-- now actually load the umlaut js helper, which will do the magic for you --> <script type="text/javascript" src=""></script>  <!-- and call embedUmlaut --> <script type="text/javascript"> embedUmlaut(((umlaut_base,umlaut_openurl_kev_co, umlaut_section_map, umlaut_options); </script>   </pre>    [[Category:Umlaut]]

Navigation menu