Downloaded 10 times
![Adding A New Facet For Matched Strings /** * Implements hook_facetapi_facet_info(). */ function apachesolr_key_phrases_facetapi_facet_info($searcher_info) { $facets = array(); if ('apachesolr' == $searcher_info['adapter']) { $facets['sm_key_phrases'] = array( 'label' => t('Key phrases'), 'description' => t('Filter by key phrases.'), ); } return $facets; } 36](https://image.slidesharecdn.com/wolanin-lsrexperiencesusingdrupalsolrfinal-131114125333-phpapp01/75/Ramp-Up-Your-Web-Experiences-Using-Drupal-and-Apache-Solr-36-2048.jpg)
Uploaded bylucenerevolution
Ramp Up Your Web Experiences Using Drupal and Apache Solr
The document discusses the integration of Drupal, a widely adopted open-source CMS, with Apache Solr to enhance web experiences. It highlights the benefits of using Drupal for content management and search features, emphasizing its extensibility and community support. The presentation aims to convince organizations to consider adopting this integrated platform for improved site performance and user engagement.
Ramp Up Your Web Experiences Using Drupal and Apache Solr
- 1.
- 2. RAMP UP YOURWEB EXPERIENCES USING DRUPAL AND APACHE SOLR peter.wolanin@acquia.com drupal.org/user/49851 (pwolanin) Peter Wolanin Momentum Specialist @ Acquia, Inc.
- 3. My Agenda Expose youto Drupal as a free enterprise CMS / WAF Describe some of the advantages that come from a large innovative pool of contributors Explain how Drupal enables you to immediately use key Apache Solr features without investing in development Have you leave here convinced that you should consider using Drupal with Apache Solr for your next project so that you can deliver a better and more engaging site faster 3
- 4. Overview of Content Whyare organizations standardizing on Drupal? Drupal integration with Apache Solr Integrated content indexing Automatic generation of facets UI configuration of search Easy extensibility of Drupal/Solr integration code 4
- 5. Inside Many Large Organizations, theWeb Is Broken 5
- 6. Standardize on DrupalAs Platform Market Presence ! Global Adoption! ! ! Massively Extensible Broad Community ! ! ! ! ! ! 1,500,000+ sites 228 countries 16,000+ modules 1,000,000+ members Active Development! ! 17,000+ developers 6
- 7. Drupal Delivers Rich,Integrated Experiences Microsite Intranet • • • • Open, flexible architecture Build a wide range of sites Repeatable deployment patterns Enables effective shared services model between IT & marketing Corp-com site 7 Main Website Microsite Product Site Community Platform Main Website
- 8. A Truly AgilePlatform February 2012 Pinterest hits 10M unique visitors March 2012 New Drupal module created for site usersʼ “pinned” images 8 April 2012 15 Drupal sites go live with Pinterest integration
- 9. Apache Solr Integrationwith Drupal Five years of integration At least 20,000 sites using Solr Active community of contributors 9
- 10. Solr Integration ChallengesAre Already Solved The most important - content indexing Facets, sorting, and highlighting Integrated with More Like This and spell-check Optionally enable content access permissions by indexing documents with data and filtering Solr results based on the current user Works with Solr 1.4.x, 3.5.x, 3.6.x, 4.x 10
- 11. Drupal Entities areContent + Data Nodes are the basic content entity The entity system is extensible can represent any data Examples of data stored within Drupal entities ‣ ‣ ‣ Node 1 Node 2 Node 3 Node 4 Node 5 Node 6 Text Node 7 Node 8 Node 9 Geographic location Node reference 11
- 12. Dynamic Content (Node)Types Enriched with Dynamic Data Fields Site builders can define as many content types as needed in the UI Each content type can have many associated data fields defined in the UI and with configurable rendering Data fields from content can be re-used across the site in listing, cross-referencing, and recombination 12
- 13.
- 14. Module Has aPipeline for Indexing Drupal Content to Solr Drupal entities are processed into one (or more) document objects Each document is converted to XML and sent to Solr. Document object Node object XML string title nid type entity_type label entity_id bundle Drupal callbacks & hooks 14 <doc> <field <field <field <field </doc> name="entity_type">node</field> name="label">Hello Drupal</field> name="entity_id">101</field> name="bundle">session</field>
- 15.
- 16. Dynamic Data NeedsDynamic Schema Fields Dyanimc content types and their data fields are defined in the UI without writing code Since the data structure is user-defined, data fields are mapped into dynamic schema fields Non-default mapping can be added in code A standard module-provided schema.xml and solrconfig.xml minimizes setup and maintenance 16
- 17. <!-- Regular text(without processing) can be stored in a string field--> <dynamicField name="ss_*" type="string" indexed="true" stored="true" multiValued="false"/> <dynamicField name="sm_*" type="string" indexed="true" stored="true" multiValued="true"/> <!-- Normal text fields are for full text - the relevance of a match depends on the length of the text --> <dynamicField name="ts_*" type="text" indexed="true" stored="true" multiValued="false" termVectors="true"/> <dynamicField name="tm_*" type="text" indexed="true" stored="true" multiValued="true" termVectors="true"/> <!-- These text fields omit norms - useful for extracted text like taxonomy_names --> <dynamicField name="tos_*" type="text" indexed="true" stored="true" multiValued="false" termVectors="true" omitNorms="true"/> <dynamicField name="tom_*" type="text" indexed="true" stored="true" multiValued="true" termVectors="true" omitNorms="true"/> 17
- 18. Entity Metadata GivesAutomatic Facets" Content types Taxonomy terms per field Content authors Posted and modified dates Text and numbers selected via select list/radios/check boxes 18
- 19.
- 20.
- 21.
- 22.
- 23.
- 24.
- 25.
- 26.
- 27.
- 28.
- 29. Fully Built SearchPages and Facets" The Drupal integration allows you to build search pages (including custom filtering) and facets with no coding Tune boosts, change query fields, and apply other configuration per “environment” (one or more search pages reference each environment) If you need deeper control, you can easily write code to change the interaction with Solr, or write custom searches 29
- 30. Drupal Modules Implementhooks to Modify Indexing and Display HOOK_apachesolr_index_document_build($document, $entity, $entity_type, $env_id) By creating a Drupal module (in PHP), you can implement module and theme “hooks” to extend or alter Drupal behavior. Change or replace the data normally indexed. Modify the search results and their appearance. 30
- 31. A Query ObjectIs Used to Prepare and Run Searches HOOK_apachesolr_query_prepare($query) $query->setParam('hl.fl', $field); $keys = $query->getParam('q'); $response = $query->search(); 31
- 32. Two Hooks ForChanging the Query? HOOK_apachesolr_query_prepare() ‣ ‣ Invoked before $query is statically cached. Add or remove sorting options visible to the user. HOOK_apachesolr_query_alter() ‣ ‣ ‣ Invoked after $query is statically cached. Useful for applying operations the user shouldnʼt have the ability to alter. For example, node access filters. 32
- 33. Example: Poor Manʼs“Entity” Extraction" Erik Hatcher recently showed how to extract values in Solr using keep words and regular expressions (Solr 4.4+) http://searchhub.org/2013/06/27/poor-mans-entityextraction-with-solr/ By shifting this work to a Drupal module, I can make it easy to configure and deploy for an existing site. module code: https://drupal.org/sandbox/pwolanin/2129005 33
- 34. Adding A NewField With Matched Strings /** * Implements hook_apachesolr_index_document_build_node(). */ function apachesolr_key_phrases_apachesolr_index_document_build_node ($document, $entity, $env_id) { $key_phrases = variable_get('key_phrases', array()); if ($key_phrases && $document->content) { foreach ($key_phrases as $phrase) { if (stripos($document->content, $phrase) !== FALSE) { $document->addField('sm_key_phrases', $phrase); } } } } 34
- 35.
- 36. Adding A NewFacet For Matched Strings /** * Implements hook_facetapi_facet_info(). */ function apachesolr_key_phrases_facetapi_facet_info($searcher_info) { $facets = array(); if ('apachesolr' == $searcher_info['adapter']) { $facets['sm_key_phrases'] = array( 'label' => t('Key phrases'), 'description' => t('Filter by key phrases.'), ); } return $facets; } 36
- 37.
- 38. To Wrap Up Drupalhas extensive Apache Solr integration, and is highly customizable The Drupal platform is widely adopted, and the Drupal community drives rapid innovation Acquia provides Enterprise Drupal support and a network of partners Acquia includes a secure, hosted Solr index with every support subscription 38