Skip to main content

Official Website

of the Commonwealth of Pennsylvania

    The .gov means its official.

    Local, state, and federal government websites often end in .gov. Commonwealth of Pennsylvania government websites and email systems use "pennsylvania.gov" or "pa.gov" at the end of the address. Before sharing sensitive or personal information, make sure you're on an official state website. 
    Search Hubs

    Location Cards - Address and Text

    Location Cards are used to display details on content pertaining to places. These can be specific address (Address cards) or general state/county/region (Text cards). They have many optional fields, allowing authors to share as much or as little information as is needed.

     

    Location Card Address- results may display in a Map component, rather than the standard Search Results. Reference the Map user guide for more info.

    Learn about Map component
    Learn about Search Results component

    Overview

    Component type: Content Fragment

    Content Fragment name: Location Cards - Text and Address

    Authors who can use: any

    Templates/page types that can use Content Fragment: must be added in configured Search Hub

    Required or optional: optional

    How to add Location Cards to a Search Hub

    1. The Author can open the Content Fragments from the assets view or on the main navigation via Content Fragments.

    2. Navigate to the Agency specific folder where the content fragment should be created.

    3. Click create Content Fragment

    a. Select the fragment model (for this example, either Location Card Address or Location Card Text).

    Content Fragment selection screen, with both Location Card types highlighted.

    b. Click Next and add the title of the Content Fragment. This title is only used within AEM and must be unique. Once added, click create.

    Content Fragment creation screen, where author enters a title, and may optionally enter a description and tags.

     

    4. Author the fields that need to display on the search result card. Not all of the fields are required, but Location Card - Address requires an address. Required fields are bolded.

    a. Location Type – Required. This is a tag and is used to identify the Search Hub. 

    b. Category

    i. This is the field for all filter tags such as Agency and Topics. All tags should be added here. 

    ii. Date tags, if not using a full date, are added here. Ex: Date year, Date month.

    c. Title – Required display title

    d. Subtitle

    e. Contact Name 1

    f. Contact Label 1

    g. Contact Name 2

    h. Contact Label 2

    i. Short Description

    j. Address lines 1,2,3 – Address line 1 is required for Location Card - Address

    k. City - Text field – Required for Location Card - Address

    l. County - Tag field 

    m. State - Tag field – Required for Location Card - Address

    n. Zip - Text field

    o. Latitude, Longitude - Required for Maps search display. Will generate automatically after Content Fragment is published. (Maps user guide coming soon)

    p. Phone Number 1 – Format phone numbers as 555-867-5309

    q. Phone Number 2 

    r. TTY Phone Number

    s. Fax

    t. Email

    u. Link Label 1 – Display label required if a URL is provided.

    v. Internal URL 1, External URL 1

    i. Can only use one, not both, for the first link display.

    w. Link Label 2

    x. Internal URL 2, External URL 2

    i. Can only use one, not both, for the second link display.

    y. Document Download 1: Link Label

    z. Document Download 1 - Pathfinder field within AEM

    aa. Document Download 2: Link Label

    bb. Document Download 2 - Pathfinder field within AEM

    cc. Additional Information - Rich Text Editor field

    dd. Date - Used for fully qualified dates.  Use the calendar icon to select date and time.

    ee. Image - Add link to image in Assets. Image will display at 220 px on the card.

    5. Publish the Content Fragment.

    6. The Content Fragment will display in the Search Hub in approximately an hour.

    Other tips

    • Location Card- Address Content Fragments need a latitude/longitude authored in order to appear in a Map. It may be added in two ways:
      • Leave the lat/long fields blank, and publish the CF. Refresh, and lat/long will appear dynamically.
      • Author the lat/long fields manually.
    • Preview Location Cards in the Stage environment. In Stage, author the Content Fragment, publish, and check that it displays correctly in the Stage page's Search Hub.
    • Not all fields are required in the Content Fragment.
    • Contact Sapient if the following is needed:
      • New tags.
      • New Search Hub.

    Sample Location Card — Address

    Partial authoring of a Location Card - Address in the Content Fragment. Figure A: Authoring dialog of the Location Card - Address, with several Content Fragment fields authored.
    Continuation of the Location Card - Address in the Content Fragment, showing the address fields. Figure B: Continuation of the Location Card - Address authoring dialog, with the address fields displaying.
    Location Card Address, with fields displaying according to Content Fragment authoring in Figure A. Figure C: The Location Card - Address as it displays in the Search Hub.

    Sample Location Card — Text

    Partial authoring of a Location Card - Text in the Content Fragment. Figure D: Authoring dialog of the Location Card - Text, with several Content Fragment fields authored.
    Location Card Text, with fields displaying according to Content Fragment authoring in Figure A. Figure E: The Location Card - Text as it displays in the Search Hub.