{"type":"doc","content":[{"type":"paragraph","content":[{"type":"placeholder","attrs":{"text":"Explain what this how-to article is for. For example, you might write an article to teach people at your company how to set up a corporate email account or file an expense report."}}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"7ba4de8c-9f7d-4f7d-b9e2-8784df2bb2b2"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"a22320f0-caad-4b19-ab03-6a9843b85c2a"}},{"type":"panel","attrs":{"panelIconId":"atlassian-info","panelIcon":":info:","panelColor":"#B3D4FF","panelType":"custom"},"content":[{"type":"paragraph","content":[{"text":"This tutorial assumes that you generated a work type name GenericWork. If you used a different name, substitute that name for all occurrences of GenericWork and generic_work.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Default properties for the show page","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"By default, the new properties will ","type":"text"},{"text":"NOT","type":"text","marks":[{"type":"strong"}]},{"text":" be displayed on the show page for works of this type. If you do nothing, which properties will be on the show page is guided by ","type":"text"},{"text":"Hyrax::WorkShowPresenter","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/samvera/hyrax/blob/master/app/presenters/hyrax/work_show_presenter.rb"}}]},{"text":" class. Look for the property names delegated to the solr_document near the top of the file.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Create a custom presenter class.","type":"text"}]},{"type":"paragraph","content":[{"text":"To add your custom metadata to the show page, first you have to create a custom presenter class. NOTE: This class is NOT created when you generate the work type.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The custom presenter class","type":"text"}]},{"type":"paragraph","content":[{"text":"Create the following as a starting point for the custom presenter class.","type":"text"}]},{"type":"codeBlock","content":[{"text":"# app/presenters/generic_work_presenter.rb\nclass GenericWorkPresenter < Hyrax::WorkShowPresenter\nend","type":"text"}]},{"type":"paragraph","content":[{"text":"Assign the presenter class in the generated controller. Edit ","type":"text"},{"text":"app/controllers/hyrax/generic_work_controller.rb","type":"text","marks":[{"type":"code"}]},{"text":" and add the following line under the curation_concern_type assignment.","type":"text"}]},{"type":"codeBlock","content":[{"text":" self.show_presenter = GenericWorkPresenter","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The modified controller class","type":"text"}]},{"type":"paragraph","content":[{"text":"The controller class now looks like…","type":"text"}]},{"type":"codeBlock","content":[{"text":"# Generated via\n# `rails generate hyrax:work GenericWork`\n\nmodule Hyrax\n class GenericWorksController < ApplicationController\n # Adds Hyrax behaviors to the controller.\n include Hyrax::WorksControllerBehavior\n include Hyrax::BreadcrumbsForWorks\n self.curation_concern_type = GenericWork\n self.show_presenter = GenericWorkPresenter\n end\nend","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Get the value from Solr","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Delegate retrieval to solr_document","type":"text"}]},{"type":"paragraph","content":[{"text":"Edit the custom presenter class (e.g. ","type":"text"},{"text":"app/presenters/generic_work_presenter.rb","type":"text","marks":[{"type":"code"}]},{"text":") and delegate the retrieval of properties to solr_document for each of the properties to be displayed.","type":"text"}]},{"type":"codeBlock","content":[{"text":" delegate :contact_email, :contact_phone, :department, to: :solr_document","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The modified presenter class","type":"text"}]},{"type":"paragraph","content":[{"text":"The full custom presenter class now looks like…","type":"text"}]},{"type":"codeBlock","content":[{"text":"# app/presenters/generic_work_presenter.rb\nclass GenericWorkPresenter < Hyrax::WorkShowPresenter\n delegate :contact_email, :contact_phone, :department, to: :solr_document\nend","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Create methods to retrieve properties from solr","type":"text"}]},{"type":"paragraph","content":[{"text":"Edit ","type":"text"},{"text":"app/models/solr_document.rb","type":"text","marks":[{"type":"code"}]},{"text":" and add a method to retrieve each property’s value from the solr doc. NOTE: Use Solrizer.solr_name to generate the solr field name for each property.","type":"text"}]},{"type":"codeBlock","content":[{"text":"def contact_email\n self[Solrizer.solr_name('contact_email')]\nend\n\ndef contact_phone\n self[Solrizer.solr_name('contact_phone')]\nend\n\ndef department\n self[Solrizer.solr_name('department')]\nend","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Add the properties to the show page","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Add to set of attributes to display","type":"text"}]},{"type":"paragraph","content":[{"text":"If this is the first custom property added to the show page, you will need to copy ","type":"text"},{"text":"Hyrax’s ","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/samvera/hyrax/blob/master/app/views/hyrax/base/_attribute_rows.html.erb"}}]},{"text":"app/views/hyrax/base/_attribute_rows.html.erb","type":"text","marks":[{"type":"code"}]},{"text":" to the same directory structure in your app. NOTE: The link goes to master. Make sure you copy from the release/branch of Hyrax that your app has installed.","type":"text"}]},{"type":"paragraph","content":[{"text":"Add the properties to the local copy of ","type":"text"},{"text":"app/views/curation_concerns/base/_attribute_rows.html.erb","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","content":[{"text":"<%= presenter.attribute_to_html(:contact_email) %>\n<%= presenter.attribute_to_html(:contact_phone) %>\n<%= presenter.attribute_to_html(:department) %>","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Default display behavior","type":"text"}]},{"type":"paragraph","content":[{"text":"Each value for the property, in this case the single value, will be displayed using a ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" tag. See ","type":"text"},{"text":"Hyrax’s default AttributeRenderer","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/samvera/hyrax/blob/master/app/renderers/hyrax/renderers/attribute_renderer.rb"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Customizing the property display","type":"text"}]},{"type":"paragraph","content":[{"text":"Optionally, you can customize the display of the property value on the show page.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Using an existing renderer","type":"text"}]},{"type":"paragraph","content":[{"text":"There are a number of common renderers already defined and in use within the Hyrax app. You can use these existing renderers for your fields. See ","type":"text"},{"text":"Hyrax’s renderers","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/samvera/hyrax/tree/master/app/renderers/hyrax/renderers"}}]},{"text":" for existing renderers.","type":"text"}]},{"type":"paragraph","content":[{"text":"To use an existing renderer (e.g. (","type":"text"},{"text":"FacetedAttributeRender","type":"text","marks":[{"type":"code"}]},{"text":")[","type":"text"},{"text":"https://github.com/samvera/hyrax/blob/master/app/renderers/hyrax/renderers/faceted_attribute_renderer.rb","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/samvera/hyrax/blob/master/app/renderers/hyrax/renderers/faceted_attribute_renderer.rb"}}]},{"text":" ]) add the attribute to ","type":"text"},{"text":"app/views/hyrax/base/_attribute_rows.html.erb","type":"text","marks":[{"type":"code"}]},{"text":" using ","type":"text"},{"text":"render_as","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"codeBlock","content":[{"text":"<%= presenter.attribute_to_html(:contact_email, render_as: :faceted) %>","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Write a general reusable custom renderer","type":"text"}]},{"type":"paragraph","content":[{"text":"A custom renderer can be written for a type of attribute, like an email or phone number, that can be used with multiple properties or a one-off renderer for a specific property. The process is the same for both.","type":"text"}]},{"type":"paragraph","content":[{"text":"To define a general renderer for all email properties…","type":"text"}]},{"type":"codeBlock","content":[{"text":"# app/renderers/email_attribute_renderer.rb\nclass EmailAttributeRenderer < CurationConcerns::Renderers::AttributeRenderer\n def attribute_value_to_html(value)\n %(#{value})\n end\nend","type":"text"}]},{"type":"paragraph","content":[{"text":"To define a general renderer for all phone properties…","type":"text"}]},{"type":"codeBlock","content":[{"text":"# app/renderers/phone_attribute_renderer.rb\nclass PhoneAttributeRenderer < CurationConcerns::Renderers::AttributeRenderer\n def attribute_value_to_html(value)\n %(#{value})\n end\nend","type":"text"}]},{"type":"paragraph","content":[{"text":"Identify the renderer to use for each property. Edit the definition in the local copy of ","type":"text"},{"text":"app/views/curation_concerns/base/_attribute_rows.html.erb","type":"text","marks":[{"type":"code"}]},{"text":" and add the ","type":"text"},{"text":"render_as","type":"text","marks":[{"type":"code"}]},{"text":" parameter for the properties.","type":"text"}]},{"type":"codeBlock","content":[{"text":"<%= presenter.attribute_to_html(:contact_email, render_as: :email) %>\n<%= presenter.attribute_to_html(:contact_phone, render_as: :phone) %>","type":"text"}]},{"type":"paragraph","content":[{"text":"NOTES:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The class name must begin with the renderer name and end with AttributeRenderer.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To identify a renderer, use the renderer name (everything upto, but not including AttributeRenderer)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can use one of the renderers defined in Hyrax.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can make more complex renderers. See Hyrax defined renderers for examples.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"Hyrax defined renderers","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/samvera/hyrax/tree/master/app/renderers/hyrax/renderers"}}]},{"text":".","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Write a property specific custom renderer","type":"text"}]},{"type":"paragraph","content":[{"text":"For controlled vocabularies, the value for the metadata field is the ID of the term. If the ID and TERM are the same, then you can use the default display behavior. Otherwise, you need a renderer that will use the controlled vocabularies service to retrieve the TERM value given the ID.","type":"text"}]},{"type":"paragraph","content":[{"text":"Define a new renderer to convert the value from the controlled value’s ID to its TERM. The renderer in this case will be specific to the controlled value property.","type":"text"}]},{"type":"paragraph","content":[{"text":"To define a property specific renderer for the department property…","type":"text"}]},{"type":"codeBlock","content":[{"text":"# app/renderers/department_attribute_renderer.rb\nclass DepartmentAttributeRenderer < CurationConcerns::Renderers::AttributeRenderer\n def attribute_value_to_html(value)\n %(#{::DepartmentsService.label(value)})\n end\nend","type":"text"}]},{"type":"paragraph","content":[{"text":"Identify the renderer to use for the property. Edit the definition in the local copy of app/views/curation_concerns/base/_attribute_rows.html.erb and add the render_as parameter for the property.","type":"text"}]},{"type":"codeBlock","content":[{"text":"<%= presenter.attribute_to_html(:department, render_as: :department) %>","type":"text"}]}],"version":1}

Browser not supported