Sites maken voor mobiele apparaten

OPMERKING

Adobe raadt aan de SPA Editor te gebruiken voor projecten die renderen op basis van één pagina voor toepassingsframework op de client-side vereisen (bijvoorbeeld Reageren). Meer informatie.

Het maken van een mobiele site lijkt op het maken van een standaardsite, omdat sjablonen en componenten moeten worden gemaakt. Raadpleeg de volgende pagina's voor meer informatie over het maken van sjablonen en componenten: Sjablonen, Componenten en Aan de slag met het ontwikkelen van AEM Sites. Het belangrijkste verschil bestaat erin de AEM ingebouwde mobiele functies binnen de site mogelijk te maken. Dit wordt bereikt door een sjabloon te maken die afhankelijk is van het component voor mobiele pagina.

U zou ook het gebruiken van responsief ontwerp moeten overwegen, die één enkele plaats creëren die veelvoudige het schermgrootte aanpast.

Om aan de slag te gaan, kunt u een blik op Wij.Retail Mobiele Plaats van de Demo hebben die in AEM beschikbaar is.

Ga als volgt te werk om een mobiele site te maken:

  1. Maak de pagina-component:

    • Stel de eigenschap sling:resourceSuperType in op wcm/mobile/components/page

      Op deze manier is de component afhankelijk van de component voor mobiele pagina.

    • Maak de body.jsp met de projectspecifieke logica.

  2. Maak de paginasjabloon:

    • Stel de eigenschap sling:resourceType in op de nieuwe paginacomponent.
    • Stel de eigenschap allowedPaths in.
  3. Maak de ontwerppagina voor de site.

  4. Maak de hoofdpagina van de site onder het knooppunt /content:

    • Stel de eigenschap cq:allowedTemplates in.
    • Stel de eigenschap cq:designPath in.
  5. Stel in de pagina-eigenschappen van de hoofdpagina van de site de apparaatgroepen in op het tabblad Mobiel.

  6. Maak de sitepagina's met de nieuwe sjabloon.

De component voor mobiele pagina ( /libs/wcm/mobile/components/page):

  • Hiermee voegt u het tabblad Mobiel toe aan het dialoogvenster met pagina-eigenschappen.
  • Via head.jsp wordt de huidige mobiele apparaatgroep opgehaald uit de aanvraag en als een apparaatgroep wordt gevonden, wordt de methode drawHead() van de groep gebruikt om de daaraan gekoppelde emulator van de apparaatgroep op te nemen in de component (alleen in de auteursmodus) en de CSS van de apparaatgroep.
OPMERKING

De wortelpagina van de mobiele plaats moet op niveau 1 van de knoophiërarchie zijn, en wordt geadviseerd om onder de /content knoop te zijn.

Een mobiele site maken met de beheer van meerdere sites

Met MSM (Multi Site Manager) kunt u een live mobiele kopie van een standaardsite maken. De standaardsite wordt automatisch getransformeerd naar een mobiele site: de mobiele site beschikt over alle functies van de mobiele sites ( bijvoorbeeld editie in een emulator ) en kan worden beheerd in synchronisatie met de standaardsite . Raadpleeg de sectie Een actieve kopie maken voor verschillende kanalen op de pagina Multi Site Manager.

Server-Side Mobile-API

De Java-pakketten met de mobiele klassen zijn:

Mobiele componenten

De We.Retail Mobile Demo Site gebruikt de volgende mobiele componenten die zich onder /libs/foundation/components bevinden:

Naam Groeperen Kenmerken
mobiele voettekst hidden - voettekst
mobiele afbeelding Mobiel - gebaseerd op de component van de beeldstichting
- geeft een beeld terug als het apparaat
geschikt is
mobiele Mobiel - gebaseerd op de lijststichtingscomponent
- listitem_teaser.jsp geeft een afbeelding weer als het apparaat geschikt is
mobilelogo verborgen - gebaseerd op de basiscomponent van het logo
- rendert een afbeelding als het apparaat geschikt is
mobilereferentie Mobiel

- vergelijkbaar met de stichtingscomponent van de referentie

- wijst een component van de textielafbeelding aan mobiletextimage toe één en een beeldcomponent aan mobiel beeld één

mobiletextimage Mobiel - op basis van de component voor de textielbasis
- geeft een afbeelding weer als het apparaat
mobiletopnav verborgen

- op basis van de bovenste grondcomponent

- alleen tekst wordt weergegeven

Een mobiele component maken

Met het AEM mobiele framework kunt u componenten ontwikkelen die gevoelig zijn voor het apparaat dat het verzoek doet. De volgende codevoorbeelden laten zien hoe u de AEM mobiele API in een componentspaak kunt gebruiken en vooral hoe u dit kunt doen:

  • Haal het apparaat op uit de aanvraag:

    Device device = slingRequest.adaptTo(Device.class);

  • De apparaatgroep ophalen:

    DeviceGroup deviceGroup = device.getDeviceGroup();

  • Krijg de mogelijkheden van de apparatengroep:

    Collection<DeviceCapability> capabilities = deviceGroup.getCapabilities();

  • Haal de apparaatkenmerken op (onbewerkte capaciteitstoets/waarden uit de WURFL-database):

    Map<String,String> deviceAttributes = device.getAttributes();

  • Haal de user-agent van het apparaat op:

    String userAgent = device.getUserAgent();

  • Haal de lijst met apparaatgroepen (apparaatgroepen die door de auteur aan de site zijn toegewezen) op van de huidige pagina:

    DeviceGroupList deviceGroupList = currentPage.adaptTo(DeviceGroupList.class);

  • Controleren of de apparaatgroep afbeeldingen ondersteunt

    if (deviceGroup.hasCapability(DeviceCapability.CAPABILITY_IMAGES)) {
    … OF
    if MobileUtil.hasCapability(request, DeviceCapability.CAPABILITY_IMAGES) {

OPMERKING

In een jsp, is slingRequest beschikbaar door de <sling:defineObjects> markering en currentPage door de <cq:defineObjects> markering.

Emulatoren

Emulatorgebaseerde authoring biedt auteurs de mogelijkheid om inhoudspagina's te maken die bedoeld zijn voor mobiele clients. Mobiele inhoud schrijven volgens hetzelfde principe als WYSIWYG bewerken. Auteurs kunnen de weergave van de pagina op een mobiel apparaat alleen zien als ze een pagina met mobiele inhoud bewerken met een apparaatemulator.

Mobiele apparaten emulators zijn gebaseerd op het generieke emulatorframework. Raadpleeg de pagina Emulators voor meer informatie.

De apparatenmededinger toont het mobiele apparaat op de pagina terwijl het gebruikelijke uitgeven (parsys, componenten) binnen het scherm van het apparaat voorkomt. De apparaatemulator is afhankelijk van de apparaatgroepen die voor de site zijn geconfigureerd. Verschillende emulators kunnen worden toegewezen aan een apparaatgroep. Alle emulators zijn vervolgens beschikbaar op de inhoudspagina. Standaard wordt de eerste emulator weergegeven die is toegewezen aan de eerste apparaatgroep die aan de site is toegewezen. Emulators kunnen worden geschakeld via de emulatorcarrousel boven aan de pagina of via de bewerkingsknop van de Sidetrap.

Emulator maken

Als u een emulator wilt maken, raadpleegt u de sectie Een aangepaste mobiele emulator maken in de algemene pagina Emulators.

Belangrijkste kenmerken van mobiele emulators

  • Een apparaatgroep bestaat uit een of meer emulators: de configuratiepagina van de apparaatgroep, bijvoorbeeld /etc/mobile/groups/touch, bevat de emulators-eigenschap onder het jcr:content-knooppunt.

    Opmerking: hoewel het mogelijk is dat dezelfde emulator tot verschillende apparaatgroepen behoort, heeft het weinig zin.

  • Via het configuratiedialoogvenster van de apparaatgroep wordt de eigenschap emulators ingesteld met het pad van de gewenste emulator(en). Bijvoorbeeld: /libs/wcm/mobile/components/emulators/iPhone4.

  • De emulatorcomponenten (bv. /libs/wcm/mobile/components/emulators/iPhone4) breidt de basis mobiele emulatorcomponent uit ( /libs/wcm/mobile/components/emulators/base).

  • Elke component die de basis mobiele emulator uitbreidt, is beschikbaar voor selectie wanneer u een apparaatgroep configureert. Aangepaste emulators kunnen dus gemakkelijk worden gemaakt of uitgebreid.

  • Op verzoek wordt de emulatorimplementatie gebruikt om de pagina weer te geven in de bewerkingsmodus.

  • Wanneer de sjabloon van de pagina afhankelijk is van de component voor mobiele pagina, worden de emulatorfuncties automatisch in de pagina geïntegreerd (via de head.jsp van de component voor mobiele pagina).

Apparaatgroepen

Mobiele apparaatgroepen bieden segmentatie van mobiele apparaten op basis van de mogelijkheden van het apparaat. Een apparatengroep verstrekt de informatie die voor op emulator-gebaseerde creatie op de auteursinstantie en voor correcte inhouderenteruggave op het publish geval wordt vereist: zodra auteurs inhoud hebben toegevoegd aan de mobiele pagina en deze hebben gepubliceerd , kan de pagina worden opgevraagd in het publicatieexemplaar . In plaats van de emulator-bewerkingsweergave wordt de inhoudspagina weergegeven met een van de geconfigureerde apparaatgroepen. De selectie van de apparaatgroep vindt plaats op basis van detectie van mobiel apparaat. De passende apparatengroep verstrekt dan de noodzakelijke het stileren informatie.

Apparaatgroepen worden gedefinieerd als inhoudspagina's onder /etc/mobile/devices en gebruiken de sjabloon Mobiele apparaatgroep. Het malplaatje van de apparatengroep dient als configuratiemalplaatje voor de definities van de apparatengroep in de vorm van inhoudspagina's. De belangrijkste kenmerken zijn:

  • Locatie: /libs/wcm/mobile/templates/devicegroup
  • Toegestaan pad: /etc/mobile/groups/*
  • Paginacomponent: wcm/mobile/components/devicegroup

Apparaatgroepen toewijzen aan uw site

Wanneer u een mobiele site maakt, moet u apparaatgroepen aan uw site toewijzen. AEM biedt drie apparaatgroepen, afhankelijk van de HTML- en JavaScript-rendermogelijkheden van het apparaat:

  • ​Featurephones voor functieapparaten zoals de Sony Ericsson W800 met ondersteuning voor standaard-HTML maar geen ondersteuning voor afbeeldingen en JavaScript.

  • ​Smartphones voor apparaten zoals Blackberry met ondersteuning voor standaard-HTML en afbeeldingen, maar geen ondersteuning voor JavaScript.

  • ​Touchphones voor apparaten zoals de iPad met volledige ondersteuning voor HTML, afbeeldingen, JavaScript en apparaatrotatie.

Aangezien emulators aan een apparaatgroep kunnen worden gekoppeld (zie de sectie Een apparaatgroep maken), kunnen auteurs door het toewijzen van een apparaatgroep aan een site een keuze maken tussen de emulators die aan de apparaatgroep zijn gekoppeld om de pagina te bewerken.

U kunt als volgt een apparaatgroep aan uw site toewijzen:

  1. Ga in uw browser naar de Siteadmin-console.

  2. Open de hoofdpagina van uw mobiele site onder Websites.

  3. Open de pagina-eigenschappen.

  4. Selecteer het tabblad Mobiel:

    • Definieer de apparaatgroepen.
    • Klik OK.
OPMERKING

Wanneer de apparaatgroepen voor een site zijn gedefinieerd, worden ze door alle pagina's van de site overgenomen.

Apparaatgroepfilters

Filters voor apparaatgroepen definiëren criteria die zijn gebaseerd op de mogelijkheid om te bepalen of een apparaat tot de groep behoort. Wanneer u een apparaatgroep maakt, kunt u de filters selecteren die u wilt gebruiken voor het evalueren van apparaten.

Wanneer AEM een HTTP-aanvraag van een apparaat ontvangt, vergelijkt elk filter dat aan een groep is gekoppeld de mogelijkheden van het apparaat met specifieke criteria. Het apparaat wordt geacht tot de groep te behoren wanneer het alle mogelijkheden heeft die de filters vereisen. Capabilities worden opgehaald uit de WURFL™-database.

Apparaatgroepen kunnen nul of meer filters gebruiken voor capaciteitsdetectie. Een filter kan ook worden gebruikt met meerdere apparaatgroepen. AEM verstrekt een standaardfilter dat bepaalt of het apparaat de mogelijkheden heeft die voor een groep worden geselecteerd:

  • CSS
  • JPG- en PNG-afbeeldingen
  • JavaScript
  • Apparaatrotatie

Als de apparatengroep geen filter gebruikt, zijn de geselecteerde mogelijkheden die voor de groep worden gevormd de enige mogelijkheden die een apparaat vereist.

Zie Apparaatgroepfilters maken voor meer informatie.

Apparaatgroep maken

Maak een apparaatgroep als de groepen die AEM installeren niet aan uw vereisten voldoen.

  1. Ga in uw browser naar de console Tools.

  2. Maak een nieuwe pagina onder Gereedschappen > Mobiel > Apparaatgroepen. In het dialoogvenster Pagina maken:

    • Als Titel ga Special Phones in.
    • Als Naam ga special in.
    • Selecteer Sjabloon mobiele apparaatgroep.
    • Klik Maken.
  3. Voeg in CRXDE een static.css dossier toe dat de stijlen voor de apparatengroep onder de /etc/mobile/groups/special knoop bevat.

  4. Open de pagina Speciale telefoons.

  5. Als u de apparaatgroep wilt configureren, klikt u op de knop Bewerken naast Instellingen.

    Op het tabblad Algemeen:

    • Titel: de naam van de mobiele apparaatgroep.
    • Omschrijving: beschrijving van de groep.
    • Gebruikersagent: user-agent-tekenreeks waar de apparaten aan worden aangepast. Het is optioneel en kan een regex zijn. Voorbeeld: BlackBerryZ10
    • Mogelijkheden: Hiermee bepaalt u of de groep afbeeldingen, CSS, JavaScript of het roteren van apparaten kan verwerken.
    • Minimale schermbreedteen -hoogte
    • Emulator uitschakelen: om de emulator tijdens het bewerken van inhoud in of uit te schakelen.

    Op het tabblad Emulatoren:

    • Emulatoren: Selecteer de emulators die aan deze apparaatgroep zijn toegewezen.

    Op het tabblad Filters:

    • Als u een filter wilt toevoegen, klikt u op Item toevoegen en selecteert u een filter in de vervolgkeuzelijst.
    • Filters worden geëvalueerd in de volgorde waarin ze worden weergegeven. Wanneer een apparaat niet aan de criteria van een filter voldoet, worden de opeenvolgende filters in de lijst niet geëvalueerd.
  6. Klik op OK.

Het dialoogvenster voor de configuratie van groepen mobiele apparaten ziet er als volgt uit:

screen_shot_2012-02-01at2043pm

Aangepaste CSS per apparaatgroep

Zoals eerder is beschreven, is het mogelijk om een aangepaste CSS te koppelen aan een apparaatgroeppagina, ongeveer zoals de CSS van een ontwerppagina. Deze CSS wordt gebruikt om de apparaatgroepspecifieke weergave van de pagina-inhoud bij auteur en publicatie te beïnvloeden.Deze CSS wordt vervolgens automatisch opgenomen:

  • In de pagina op de auteurinstantie voor elke mededinger die door deze apparatengroep wordt gebruikt.
  • In de pagina op de publicatieinstantie als de gebruikersagent van de aanvraag overeenkomt met een mobiel apparaat in deze specifieke apparaatgroep.

Apparaatdetectie op de server

Gebruik filters en een bibliotheek met apparaatspecificaties om de mogelijkheden te bepalen van het apparaat dat de HTTP-aanvraag uitvoert.

Apparaatgroepfilters ontwikkelen

Maak een apparaatgroepfilter om een set vereisten voor apparaatmogelijkheden te definiëren. Maak zoveel filters als u nodig hebt om de benodigde groepen apparaatmogelijkheden als doel in te stellen.

Ontwerp uw filters zodat u combinaties ervan kunt gebruiken om de groepen mogelijkheden te bepalen. Gewoonlijk zijn de mogelijkheden van verschillende apparaatgroepen elkaar overlappen. Daarom zou u sommige filters met veelvoudige definities van de apparatengroep kunnen gebruiken.

Nadat u een filter creeert, kunt u het in de groepsconfiguratie gebruiken.

Ga voor meer informatie naar Apparaatgroepfilters maken.

De WURFL™-database gebruiken

AEM gebruikt een afgekapte versie van WURFL™ gegevensbestand aan vraagapparatenmogelijkheden, zoals het schermresolutie of javascript steun, die op de gebruiker-Agent van het apparaat wordt gebaseerd.

De XML-code van de WURFL™-database wordt weergegeven als knooppunten onder /var/mobile/devicespecs door het wurfl.xmlbestand op /libs/wcm/mobile/devicespecs/wurfl.xml. te parseren. De uitbreiding naar knooppunten vindt plaats wanneer de cq-mobile-core-bundel voor de eerste keer wordt gestart.

Apparaatmogelijkheden worden opgeslagen als knoopeigenschappen en knooppunten vertegenwoordigen apparaatmodellen. U kunt query's gebruiken om de mogelijkheden van een apparaat of gebruikersagent op te halen.

Aangezien het WURFL™ gegevensbestand evolueert, kunt u het moeten aanpassen of vervangen. Voor het bijwerken van de database voor mobiele apparaten hebt u de volgende opties:

  • Vervang het bestand door de nieuwste versie als u een licentie hebt die dit gebruik toestaat. Zie Een andere WURFL-database installeren.
  • Gebruik de versie die in AEM beschikbaar is en vorm een regexp die uw gebruiker-Agent koorden en punten aan een bestaand apparaat WURFL™ aanpast. Zie Een op regexp-Gebaseerde gebruiker-Agent Matching toevoegen.

Het testen van de Afbeelding van een Gebruiker-Agent aan Mogelijkheden WURFL™

Wanneer een apparaat toegang krijgt tot uw mobiele site, detecteert AEM het apparaat, wijst het apparaat toe aan een apparaatgroep op basis van zijn mogelijkheden en verzendt het een weergave van de pagina die overeenkomt met de apparaatgroep. De overeenkomende apparaatgroep bevat de vereiste opmaakgegevens. De toewijzingen kunnen op de Mobiele Gebruiker-Agent Pagina van de Test worden getest:

http://localhost:4502/etc/mobile/useragent-test.html

Een andere WURFL™-database installeren

De afgekapte WURFL™-database die met AEM is geïnstalleerd, is een release die dateert van vóór
30 augustus 2011. Als uw versie van WURFL na 30 augustus 2011 is uitgebracht, moet u ervoor zorgen dat uw gebruik voldoet aan uw licentie.

Een WURFL™-database installeren:

  1. Maak de volgende map in CRXDE Lite: /apps/wcm/mobile/devicespecs
  2. Kopieer het WURFL™-bestand naar de map.
  3. Wijzig de naam van het bestand in wurfl.xml.

AEM het wurfl.xml-bestand automatisch parseert en de knooppunten onder /var/mobile/devicespecs bijwerkt.

OPMERKING

Wanneer de volledige WURFL™-database is ingeschakeld, kan het parseren en activeren enkele minuten duren. U kunt de logboeken bekijken voor voortgangsinformatie.

Een op regexp gebaseerde overeenkomst tussen gebruiker en agent toevoegen

Voeg een user-agent als regelmatige uitdrukking onder /apps/wcm/mobile/devicespecs/wurfl/regexp toe om aan een bestaand WURFL™ apparatentype te richten.

  1. Maak in CRXDE Lite een knooppunt onder /apps/wcm/mobile/devicespecs/regexp, bijvoorbeeld apple_ipad_ver1.

  2. Voeg de volgende eigenschappen toe aan het knooppunt:

    • regexp: reguliere expressie die user-agents definieert, bijvoorbeeld: .*Mozilla.*iPad.*AppleWebKit.*Safari.*
    • deviceId: de apparaat-id zoals gedefinieerd in het bestand wurfl.xml, bijvoorbeeld: apple_ipad_ver1

De bovenstaande configuratie veroorzaakt apparaten waarvoor de gebruiker-Agent de geleverde regelmatige uitdrukking aanpast om aan apple_ipad_ver1 WURFL™ apparatenidentiteitskaart worden in kaart gebracht, als het bestaat.

Apparaatdetectie op de client

In deze sectie wordt beschreven hoe u de clientdetectie van AEM van het apparaat kunt gebruiken om de weergave van pagina's te optimaliseren of om de client alternatieve websiteversies te bieden.

AEM ondersteunt apparaatclientdetectie op basis van BrowserMap. BrowserMap wordt in AEM verzonden als een clientbibliotheek onder /etc/clientlibs/browsermap.

BrowserMap biedt u drie strategieën waarmee u een alternatieve website aan een client kunt aanbieden. Deze worden in de volgende volgorde gebruikt:

  1. Alternatieve koppelingen

  2. Specifieke URL voor apparaatgroep

  3. Op kiezer gebaseerde URL

OPMERKING

Voor meer informatie over de integratie van de Bibliotheek van de Cliënt, te lezen gelieve Gebruikend Cliënt-zij HTML Bibliotheken sectie.

Met de OSGi-service van PageVariantsProvider kunt u alternatieve koppelingen genereren voor sites die tot dezelfde familie behoren. Als u sites wilt configureren waarmee de service rekening moet houden, moet een cq:siteVariant-knooppunt worden toegevoegd aan het jcr:content-knooppunt vanaf de hoofdmap van de site.

De cq:siteVariant knoop moet de volgende eigenschappen hebben:

  • cq:childNodesMapTo - bepaalt aan welk kenmerk van het koppelingselement de onderliggende knooppunten worden toegewezen; het wordt aanbevolen de inhoud van uw website zodanig te ordenen dat de onderliggende items van het hoofdknooppunt de basis vormen voor een taalvariant van uw globale website (bijvoorbeeld /content/mysite/en, /content/mysite/de), in welk geval de waarde van het cq:childNodesMapTo moet hreflangzijn;

  • cq:variantDomain - geeft aan welk Externalizer domein wordt gebruikt om de absolute URL's van de paginariabelen te genereren; als deze waarde niet is ingesteld, worden de paginariabelen gegenereerd met relatieve koppelingen;

  • cq:variantFamily - geeft aan tot welke familie van websites deze site behoort; meerdere apparaatspecifieke vertegenwoordigingen van dezelfde website moeten tot dezelfde familie behoren;

  • media - slaat de waarden van het mediakenmerk van het koppelingselement op; het wordt aanbevolen de naam van de BrowserMap geregistreerde website te gebruiken DeviceGroups, zodat de BrowserMap bibliotheek de clients automatisch naar de juiste variant van de website kan doorsturen.

PageVariantsProvider en ExternalAlizer

Wanneer de waarde van het cq:variantDomain bezit van een cq:siteVariant knoop niet leeg is, zal de PageVariantsProvider dienst absolute verbindingen produceren gebruikend deze waarde als gevormd domein voor de Externalizer dienst. Zorg ervoor om de Externalizer dienst te vormen om uw opstelling te weerspiegelen.

OPMERKING

Wanneer het werken met AEM zijn er verscheidene methodes om de configuratiemontages voor dergelijke diensten te beheren; zie Het vormen OSGi voor meer details en de geadviseerde praktijken.

Een apparaatgroepspecifieke URL definiëren

Als u geen afwisselende verbindingen wilt gebruiken, kunt u een globale URL voor elke DeviceGroup vormen. We raden u aan uw eigen clientbibliotheek te maken die de clientbibliotheek browsermap.standard insluit, maar de apparaatgroepen opnieuw definieert.

BrowserMap is zodanig ontworpen dat de definities van Apparaatgroepen kunnen worden overschreven door een nieuwe apparaatgroep met dezelfde naam te maken en toe te voegen aan het BrowserMap-object uit uw aangepaste clientbibliotheek.

OPMERKING

Lees voor meer informatie de sectie Aangepaste BrowserMap.

Op kiezer gebaseerde URL's definiëren

Als geen van de vorige mechanismen is gebruikt om een alternatieve site aan te geven voor BrowserMap, worden kiezers die de namen van DeviceGroups gebruiken, toegevoegd aan de URLs. In dat geval moet u uw eigen servlets opgeven die de aanvragen zullen verwerken.

Bijvoorbeeld een apparaat dat www.example.com/index.html als smartphone door BrowserMap wordt geïdentificeerd door door:sturen aan www.example.com/index.smartphone.html.

BrowserMap gebruiken op uw pagina's

Als u de standaard BrowserMap-clientbibliotheek op een pagina wilt gebruiken, moet u het /libs/wcm/core/browsermap/browsermap.jsp-bestand opnemen met een cq:includetag in de sectie head van de pagina.

<cq:include script="/libs/wcm/core/browsermap/browsermap.jsp" />

Naast het toevoegen van de BrowserMap cliëntbibliotheek in uw JSP dossiers, moet u ook een cq:deviceIdentificationMode bezit van het Koord toevoegen dat aan client-side aan jcr:content knoop onder de wortel van uw website wordt geplaatst.

Standaardgedrag van BrowserMap negeren

Als u BrowserMap wilt aanpassen - door DeviceGroups met voeten te treden of meer sondes toe te voegen - dan zou u uw eigen cliënt-zijbibliotheek moeten creëren waarin u browsermap.standardcliënt-zijbibliotheek inbedt.

Bovendien moet u de BrowserMap.forwardRequest() methode in uw JavaScript code manueel roepen.

OPMERKING

Voor meer informatie over de integratie van de Bibliotheek van de Cliënt, te lezen gelieve Gebruikend Cliënt-zij HTML Bibliotheken sectie.

Zodra u uw aangepaste BrowserMap cliëntbibliotheek hebt gecreeerd, stellen wij de volgende benadering voor:

  1. Een browsermap.jsp-bestand maken in uw toepassing

    <%@include file="/libs/foundation/global.jsp" %>
    <%@ taglib prefix="c" uri="https://java.sun.com/jsp/jstl/core" %>
    <%@ page import="
        com.day.cq.wcm.api.variants.PageVariant,
        com.day.cq.wcm.api.variants.PageVariantsProvider,
        com.day.cq.wcm.api.devicedetection.DeviceIdentificationMode,
        com.day.cq.wcm.api.WCMMode"
    %>
    <%
        final PageVariantsProvider p = sling.getService(PageVariantsProvider.class);
        if(p == null) {
            throw new IllegalStateException("Missing PageVariantsProvider service");
        }
        for(PageVariant v : p.getVariants(currentPage, slingRequest)) {
            final String curVar = v.getAttributes().get("data-current-variant");
            String media = v.getAttributes().get("media");
            if (media != null) {
                media = media.replaceAll(" ", "");
            }
    %>
        <link
            rel="alternate"
            data-cq-role="site.variant"
            title="<%= xssAPI.encodeForHTMLAttr(v.getTitle()) %>"
            hreflang="<%= xssAPI.encodeForHTMLAttr(v.getAttributes().get("hreflang")) %>"
            media="<%= xssAPI.encodeForHTMLAttr(media) %>"
            href="<%= xssAPI.getValidHref(v.getURL()) %>"
            <% if(curVar != null) { %> data-current-variant="<%= curVar %>"<% } %>
        />
    <%
        }
        Boolean browserMapEnabled = true;
        final DeviceIdentificationMode dim = sling.getService(DeviceIdentificationMode.class);
        String[] selectors  = slingRequest.getRequestPathInfo().getSelectors();
        boolean isPortletRequest = false;
        for (int i = 0; i < selectors.length; i++) {
            if ("portlet".equals(selectors[i])) {
                isPortletRequest = true;
                break;
            }
        }
        if (isPortletRequest) {
            log.debug("Request was made by a portlet container - BrowserMap will not be embedded");
        } else {
            final WCMMode wcmMode = WCMMode.fromRequest(slingRequest);
            boolean shouldIncludeClientLib = false;
            if (WCMMode.EDIT != wcmMode && WCMMode.PREVIEW != wcmMode && WCMMode.DESIGN != wcmMode) {
                if (dim != null) {
                    final String mode = dim.getDeviceIdentificationModeForPage(currentPage);
                    shouldIncludeClientLib = DeviceIdentificationMode.CLIENT_SIDE.equals(mode);
                    if (shouldIncludeClientLib) {
                        browserMapEnabled = (Boolean) request.getAttribute("browsermap.enabled");
                        if (browserMapEnabled == null) {
                            browserMapEnabled = true;
                        }
                    }
                }
            }
    %>
            <c:if test="<%= !browserMapEnabled %>">
                <meta name="browsermap.enabled" content="false">
            </c:if>
            <c:if test="<%= shouldIncludeClientLib %>">
                <meta name="viewport" content="width=device-width, initial-scale=1.0">
                <cq:includeClientLib categories="browsermap.custom"/>
            </c:if>
    <%
        }
    %>
    
  2. Neem het bestand broswermap.jsp op in de kopsectie.

    <cq:include script="browsermap.jsp" />
    

BrowserMap uitsluiten van bepaalde pagina's

Als u de bibliotheek BrowserMap van sommige van uw pagina's zou willen uitsluiten waar u geen cliënt-opsporing nodig hebt, kunt u een verzoekattribuut toevoegen:

<%
request.setAttribute("browsermap.enabled", false);
%>

Hierdoor wordt in het script /libs/wcm/core/browsermap/browsermap.jsp een metatag toegevoegd aan de pagina die BrowserMap maakt om geen detectie uit te voeren:

<meta name="browsermap.enabled" content="false">

Een specifieke versie van een website testen

Doorgaans leidt het BrowserMap-script bezoekers altijd naar de meest geschikte versie van de website, waarbij bezoekers doorgaans naar het bureaublad of de mobiele site worden omgeleid wanneer dat nodig is.

U kunt het apparaat van om het even welk verzoek dwingen om een specifieke versie van een website te testen door de device parameter aan uw URL toe te voegen. Met de volgende URL wordt de mobiele versie van de website Geometrixx Outdoors weergegeven.

http://localhost:4502/content/geometrixx-outdoors/en.html?wcmmode=disabled&device=smartphone

OPMERKING

De wcmmode-parameter wordt ingesteld op disabled om het gedrag van een publicatie-instantie te simuleren.

De overschreven apparaatwaarde wordt opgeslagen in een cookie, zodat u door uw website kunt bladeren zonder de parameter device aan elke URL toe te voegen.

Als gevolg hiervan moet u dezelfde URL aanroepen met device ingesteld op browser om terug te keren naar de bureaubladversie van de website.

OPMERKING

BrowserMap slaat de overschreven apparaatwaarde op in een cookie met de naam BMAP_device. Als u deze cookie verwijdert, zorgt u ervoor dat CQ de juiste versie van de website aanbiedt op basis van uw huidige apparaat (bijvoorbeeld bureaublad of mobiel).

Mobiele aanvraagverwerking

AEM verwerkt als volgt een aanvraag die is uitgegeven door een mobiel apparaat dat tot de aanraakapparaatgroep behoort:

  1. Een iPad verzendt een verzoek naar de AEM-publicatie-instantie, bijvoorbeeld http://localhost:4503/content/geometrixx_mobile/en/products.html

  2. AEM bepaalt of de site van de aangevraagde pagina een mobiele site is (door te controleren of de pagina /content/geometrixx_mobile op het eerste niveau een uitbreiding vormt voor de component van de mobiele pagina). Zo ja:

  3. AEM kijkt omhoog de apparatenmogelijkheden die op gebruiker-Agent in de verzoekkopbal worden gebaseerd.

  4. AEM wijst de apparatenmogelijkheden aan de apparatengroep toe en plaatst touch als selecteur van de apparatengroep.

  5. AEM richt het verzoek aan http://localhost:4503/content/geometrixx_mobile/en/products.touch.html. opnieuw

  6. AEM verzendt het antwoord naar de iPad:

    • products.touch.html wordt op de gebruikelijke manier weergegeven en is in cache geplaatst.
    • De renderingcomponenten gebruiken kiezers om de presentatie aan te passen.
    • AEM voegt automatisch de mobiele kiezer toe aan alle interne koppelingen op de pagina.

Statistieken

U kunt statistieken opvragen over het aantal aanvragen dat door mobiele apparaten bij de AEM server is ingediend. Het aantal aanvragen kan worden uitgesplitst:

  • per apparaatgroep en apparaat
  • per jaar, maand en dag

De statistieken weergeven:

  1. Ga naar Tools console.

  2. Open de pagina Apparaatstatistieken onder Gereedschappen > Mobiel.

  3. Klik op de koppeling om de statistieken voor een bepaald jaar, een bepaalde maand of een bepaalde dag weer te geven.

De pagina Statistieken ziet er als volgt uit:

screen_shot_2012-02-01at24353pm

OPMERKING

De pagina Statistics wordt gemaakt wanneer een mobiel apparaat voor het eerst toegang krijgt tot AEM en wordt gedetecteerd. Daarvoor is het niet beschikbaar.

Als u een ingang in de statistieken moet produceren, kunt u als volgt te werk gaan:

  1. Gebruik een mobiel apparaat of een emulator (bijvoorbeeld https://chrispederick.com/work/user-agent-switcher/ op Firefox).

  2. Vraag een mobiele pagina aan op de auteurinstantie door de auteurswijze onbruikbaar te maken, b.v.:

    http://localhost:4502/content/geometrixx_mobile/en/products.html?wcmmode=disabled

De pagina Statistieken is nu beschikbaar.

Mobiele pagina's kunnen doorgaans in de cache van Dispatcher worden geplaatst, omdat pagina's die voor een apparaatgroep worden weergegeven, in de pagina-URL worden onderscheiden door de kiezer van de apparaatgroep, bijvoorbeeld /content/mobilepage.touch.html. Een aanvraag naar een mobiele pagina zonder kiezer wordt nooit in de cache geplaatst, aangezien in dit geval de apparaatdetectie werkt en ten slotte wordt omgeleid naar de overeenkomende apparaatgroep (of "nomatch" voor dat geval). Een mobiele pagina die wordt weergegeven met een apparaatgroepkiezer, wordt verwerkt door de koppelingenrewriter, die alle koppelingen binnen de pagina herschrijft om ook de apparaatgroepkiezer te bevatten, zodat apparaatdetectie niet opnieuw kan worden uitgevoerd voor elke klik op een reeds gekwalificeerde pagina.

Daarom zou u het volgende scenario kunnen ontmoeten:

Alice van de gebruiker wordt opnieuw gericht aan coolpage.feature.html, en verzendt die URL naar een vriendLoodje die tot het met een verschillende cliënt toegang heeft die in de touch apparatengroep valt.

Als coolpage.feature.html van een front-end geheime voorgeheugen wordt gediend, krijgt AEM geen kans om het verzoek te analyseren om te weten te komen dat de mobiele selecteur niet de nieuwe gebruiker-Agent aanpast, en het Loodje krijgt de verkeerde vertegenwoordiging.

Als u dit wilt oplossen, kunt u een eenvoudige selectie-UI op de pagina's opnemen, waar eindgebruikers de apparaatgroep die is geselecteerd door AEM kunnen overschrijven. In het bovenstaande voorbeeld kan de eindgebruiker met een koppeling (of een pictogram) op de pagina naar coolpage.touch.html schakelen als hij vindt dat zijn apparaat hiervoor geschikt is.

Op deze pagina