Skapa platser för mobila enheter

OBSERVERA

Adobe rekommenderar att du använder SPA Editor för projekt som kräver ramverksbaserad klientåtergivning för en sida (t.ex. Reagera). Läs mer.

Att skapa en mobilwebbplats liknar att skapa en standardwebbplats, eftersom det även handlar om att skapa mallar och komponenter. Mer information om hur du skapar mallar och komponenter finns på följande sidor: Mallar, Komponenter och Komma igång med att utveckla AEM Sites. Den största skillnaden är att aktivera de AEM inbyggda mobilfunktionerna på webbplatsen. Detta uppnås genom att skapa en mall som är beroende av mobilsidkomponenten.

Du bör också överväga att använda responsiv design och skapa en plats som kan hantera flera skärmstorlekar.

Du kan komma igång genom att titta på Webbplatsen för mobil demo som finns i AEM.

Så här skapar du en mobilwebbplats:

  1. Skapa sidkomponenten:

    • Ställ in egenskapen sling:resourceSuperTypewcm/mobile/components/page
      På så sätt är komponenten beroende av den mobila sidkomponenten.

    • Skapa body.jsp med projektspecifik logik.

  2. Skapa sidmallen:

    • Ange egenskapen sling:resourceType för den nya sidkomponenten.
    • Ange egenskapen allowedPaths.
  3. Skapa designsidan för webbplatsen.

  4. Skapa platsrotsidan under noden /content:

    • Ange egenskapen cq:allowedTemplates.
    • Ange egenskapen cq:designPath.
  5. Ange enhetsgrupperna på fliken Mobile i sidegenskaperna för webbplatsens rotsida.

  6. Skapa webbplatssidorna med den nya mallen.

Komponenten för mobilsidan ( /libs/wcm/mobile/components/page):

  • Lägger till fliken Mobil i dialogrutan för sidegenskaper.
  • Genom sin head.jsp hämtar den aktuella mobilenhetsgruppen från begäran och om en enhetsgrupp hittas använder gruppens drawHead()-metod för att inkludera enhetsgruppens associerade init-komponent för emulering (endast i redigeringsläge) och enhetsgruppens återgivnings-CSS.
OBSERVERA

Rotsidan för den mobila webbplatsen måste vara på nivå 1 i nodhierarkin och bör vara under noden /content.

Skapa en mobilwebbplats med Multi Site Manager

Använd Multi Site Manager (MSM) för att skapa en mobil live kopia från en standardwebbplats. Standardwebbplatsen omvandlas automatiskt till en mobil webbplats: mobilsajten har alla funktioner som finns på mobilsajterna (t.ex. utgåva i en emulator) och kan hanteras synkroniserat med standardsajten. Se avsnittet Skapa en Live-kopia för olika kanaler på sidan Multi Site Manager.

Mobil-API för serversidan

Java-paketen som innehåller de mobila klasserna är:

Mobilkomponenter

I We.Retail Mobile Demo Site används följande mobila komponenter som finns under /libs/foundation/components:

Namn Grupp Egenskaper
mobilefooter hidden - sidfot
mobileimage Mobil - baserat på bildstiftskomponenten
- återger en bild om enheten kan
mobilelist Mobil - baserat på listgrundskomponenten
- listitem_teaser.jsp återger en bild om enheten är kapabel
mobilelogo dold - baserat på komponenten
som bygger på logotypen - återger en bild om enheten kan
mobilreferens Mobil

- som liknar komponenten för referensgrunden

- mappar en textimage-komponent till en mobilextimage en och en image-komponent till en mobilbild en

mobiletextimage Mobil - baserat på komponenten textimage Foundation
- återger en bild om enheten kan
mobiletopnav dold

- baserat på den topnav Foundation-komponenten

- återger bara text

Skapa en mobilkomponent

Det AEM mobilramverket gör det möjligt att utveckla komponenter som är känsliga för den enhet som skickar begäran. I följande kodexempel visas hur du använder det AEM Mobile API:t i en komponent-jsp och särskilt hur du gör det:

  • Hämta enheten från begäran:
    Device device = slingRequest.adaptTo(Device.class);

  • Hämta enhetsgruppen:
    DeviceGroup deviceGroup = device.getDeviceGroup();

  • Hämta enhetsgruppsfunktionerna:
    Collection<DeviceCapability> capabilities = deviceGroup.getCapabilities();

  • Hämta enhetsattributen (nyckel/värden för rå kapacitet från WURFL-databasen):
    Map<String,String> deviceAttributes = device.getAttributes();

  • Hämta enhetens användaragent:
    String userAgent = device.getUserAgent();

  • Hämta enhetsgruppslistan (enhetsgrupper som tilldelats till webbplatsen av författaren) från den aktuella sidan:
    DeviceGroupList deviceGroupList = currentPage.adaptTo(DeviceGroupList.class);

  • Kontrollera om enhetsgruppen stöder bilder
    if (deviceGroup.hasCapability(DeviceCapability.CAPABILITY_IMAGES)) {
    … ELLER … if MobileUtil.hasCapability(request, DeviceCapability.CAPABILITY_IMAGES) {

OBSERVERA

I en jsp är slingRequest tillgängligt via taggen <sling:defineObjects> och currentPage via taggen <cq:defineObjects>.

Emulatorer

Emulatorbaserad redigering ger författare möjlighet att skapa innehållssidor som är avsedda för mobila klienter. Framtagning av mobilt innehåll följer samma princip för WYSIWYG-redigering på plats. För att författare ska kunna uppfatta sidutseendet på en mobil enhet redigeras en mobilinnehållssida med en enhetsemulator.

Emulatorer för mobila enheter är baserade på det generiska emulatorramverket. Mer information finns på sidan Emulatorer.

Enhetsemulatorn visar den mobila enheten på sidan medan den vanliga redigeringen (parsys, components) sker på enhetens skärm. Enhetsemulatorn beror på de enhetsgrupper som är konfigurerade för platsen. Flera emulatorer kan tilldelas till en enhetsgrupp. Alla emulatorer är sedan tillgängliga på innehållssidan. Som standard visas den första emulatorn som tilldelats den första enhetsgruppen som tilldelats platsen. Emulatorerna kan bytas antingen via emulatorkarusellen högst upp på sidan eller via Sidekes redigeringsknapp.

Skapa en emulator

Om du vill skapa en emulator läser du avsnittet Skapa en anpassad emulator på den generiska emulatorsidan.

De viktigaste egenskaperna hos emulatorer för mobila enheter

  • En enhetsgrupp består av en av flera emulatorer: konfigurationssidan för enhetsgruppen, t.ex. /etc/mobile/groups/touch, innehåller egenskapen emulators nedanför noden jcr:content.
    Obs! Även om det är möjligt att samma emulator tillhör flera enhetsgrupper så är det inte särskilt klokt.

  • Via enhetsgruppens konfigurationsdialogruta ställs egenskapen emulators in med sökvägen till önskad emulator(er). Till exempel: /libs/wcm/mobile/components/emulators/iPhone4.

  • Emulatorkomponenter (t.ex. /libs/wcm/mobile/components/emulators/iPhone4) utöka basmobilemulatorkomponenten ( /libs/wcm/mobile/components/emulators/base).

  • Alla komponenter som utökar basmobilemulatorn är tillgängliga för val när en enhetsgrupp konfigureras. Anpassade emulatorer kan enkelt skapas eller utökas.

  • Vid begäran i redigeringsläge används emulatorimplementeringen för att återge sidan.

  • När sidmallen är beroende av mobilsidkomponenten, integreras emulatorfunktionerna automatiskt på sidan (via head.jsp för mobilsidkomponenten).

Enhetsgrupper

Mobila enhetsgrupper ger segmentering av mobila enheter baserat på enhetens funktioner. En enhetsgrupp innehåller den information som krävs för emulatorbaserad redigering på författarinstansen och för korrekt innehållsåtergivning på publiceringsinstansen: När författarna har lagt till innehåll på mobilsidan och publicerat det kan sidan begäras på publiceringsinstansen. I stället för emulatorns redigeringsvy återges innehållssidan med en av de konfigurerade enhetsgrupperna. Valet av enhetsgrupp görs baserat på identifiering av mobila enheter. Den matchande enhetsgruppen tillhandahåller sedan nödvändig formatinformation.

Enhetsgrupper definieras som innehållssidor under /etc/mobile/devices och använder mallen Mobile Device Group. Enhetens gruppmall fungerar som en konfigurationsmall för enhetsgruppsdefinitioner i form av innehållssidor. Dess huvudsakliga egenskaper är:

  • Plats: /libs/wcm/mobile/templates/devicegroup
  • Tillåten sökväg: /etc/mobile/groups/*
  • Sidkomponent: wcm/mobile/components/devicegroup

Tilldela enhetsgrupper till din plats

När du skapar en mobilwebbplats måste du tilldela enhetsgrupper till webbplatsen. AEM innehåller tre enhetsgrupper beroende på enhetens HTML- och JavaScript-återgivningsfunktioner:

  • Funktioner för enheter som Sony Ericsson W800 med stöd för grundläggande HTML, men utan stöd för bilder och JavaScript.

  • Smarttelefoner, för enheter som Blackberry med stöd för grundläggande HTML och bilder, men inget stöd för JavaScript.

  • ​Touchphones, för enheter som iPad med fullt stöd för HTML, bilder, JavaScript och enhetsrotation.

När emulatorer kan kopplas till en enhetsgrupp (se avsnittet Skapa en enhetsgrupp) kan författare som tilldelar en enhetsgrupp till en plats välja mellan de emulatorer som är kopplade till enhetsgruppen för att redigera sidan.

Så här tilldelar du en enhetsgrupp till din plats:

  1. Gå till konsolen SiteAdmin i webbläsaren.

  2. Öppna rotsidan för den mobila webbplatsen under Webbplatser.

  3. Öppna sidegenskaperna.

  4. Välj fliken Mobil:

    • Definiera enhetsgrupperna.
    • Klicka på OK.
OBSERVERA

När enhetsgrupperna har definierats för en plats, ärvs de av alla sidor på platsen.

Enhetsgruppsfilter

Enhetsgruppsfilter definierar funktionsbaserade villkor för att avgöra om en enhet tillhör gruppen. När du skapar en enhetsgrupp kan du välja vilka filter som ska användas för att utvärdera enheter.

Vid körning när AEM tar emot en HTTP-begäran från en enhet, jämför varje filter som är kopplat till en grupp enhetsfunktionerna med specifika kriterier. Enheten anses tillhöra gruppen när den har alla funktioner som filtren kräver. Funktioner hämtas från WURFL™-databasen.

Enhetsgrupper kan använda noll eller flera filter för funktionsidentifiering. Ett filter kan också användas med flera enhetsgrupper. AEM innehåller ett standardfilter som avgör om enheten har de funktioner som är valda för en grupp:

  • CSS
  • JPG- och PNG-bilder
  • JavaScript
  • Enhetsrotation

Om enhetsgruppen inte använder ett filter är de valda funktionerna som är konfigurerade för gruppen de enda funktioner som en enhet behöver.

Mer information finns i Skapa enhetsgruppsfilter.

Skapar en enhetsgrupp

Skapa en enhetsgrupp när de grupper som AEM installerar inte uppfyller dina krav.

  1. Gå till konsolen Verktyg i webbläsaren.

  2. Skapa en ny sida under Verktyg > Mobil > Enhetsgrupper. I dialogrutan Skapa sida:

    • Som Titel anger du Special Phones.

    • Som Namn anger du special.

    • Välj Mallen för mobilenhetsgrupp.

    • Klicka på Skapa.

  3. I CRXDE lägger du till en static.css-fil som innehåller stilarna för enhetsgruppen under noden /etc/mobile/groups/special.

  4. Öppna sidan Specialtelefoner.

  5. Om du vill konfigurera enhetsgruppen klickar du på knappen Redigera bredvid Inställningar.
    På fliken Allmänt:

    • Titel: namnet på mobilenhetsgruppen.
    • Beskrivning: beskrivning av gruppen.
    • Användaragent: användaragentsträng som enheterna matchas mot. Den är valfri och kan vara en regex. Exempel: BlackBerryZ10
    • Funktioner: definierar om gruppen kan hantera bilder, CSS, JavaScript eller enhetsrotation.
    • Minsta skärmbreddoch -höjd
    • Inaktivera emulatorn: för att aktivera/inaktivera emulatorn under innehållsredigering.

    På fliken Emulatorer:

    • Emulatorer: Välj emulatorerna som är tilldelade den här enhetsgruppen.

    På fliken Filter:

    • Om du vill lägga till ett filter klickar du på Lägg till objekt och väljer ett filter i listrutan.
    • Filter utvärderas i den ordning som de visas. När en enhet inte uppfyller filtervillkoren utvärderas inte efterföljande filter i listan.
  6. Klicka på OK.

Dialogrutan för konfiguration av mobilenhetsgrupp ser ut så här:

screen_shot_2012-02-01at22043pm

Anpassad CSS per enhetsgrupp

Så som beskrivs ovan är det möjligt att koppla en anpassad CSS till en enhetsgruppssida, ungefär som CSS för en designsida. Den här CSS används för att påverka den enhetsgruppsspecifika återgivningen av sidinnehållet vid författaren och vid publiceringen. Den här CSS-koden inkluderas sedan automatiskt:

  • På sidan för författarinstansen för varje emulator som används av den här enhetsgruppen.
  • På sidan i publiceringsinstansen om användaragenten för begäran matchar en mobil enhet i den här enhetsgruppen.

Enhetsidentifiering på serversidan

Använd filter och ett bibliotek med enhetsspecifikationer för att avgöra vilka funktioner den enhet som utför HTTP-begäran har.

Skapa enhetsgruppsfilter

Skapa ett enhetsgruppsfilter för att definiera en uppsättning krav för enhetsfunktioner. Skapa så många filter du behöver för att rikta in dig på de grupper av enhetsfunktioner som behövs.

Utforma dina filter så att du kan använda kombinationer av dem för att definiera grupper av funktioner. Vanligtvis finns det överlappande funktioner för olika enhetsgrupper. Därför kan du använda vissa filter med flera enhetsgruppsdefinitioner.

När du har skapat ett filter kan du använda det i gruppkonfigurationen.

Mer information finns i Skapa enhetsgruppsfilter.

Använda WURFL™-databasen

AEM använder en trunkerad version av WURFL™-databasen för att fråga efter enhetsfunktioner, som skärmupplösning eller stöd för javascript, baserat på enhetens användaragent.

XML-koden för WURFL™-databasen representeras som noder under /var/mobile/devicespecs genom att filen wurfl.xmlanalyseras vid /libs/wcm/mobile/devicespecs/wurfl.xml. Utökningen till noder sker första gången cq-mobile-core-paketet startas.

Enhetsfunktionerna lagras som nodegenskaper och noderna representerar enhetsmodeller. Du kan använda frågor för att hämta funktionerna för en enhet eller en användaragent.

I takt med att WURFL™-databasen utvecklas kan du behöva anpassa eller ersätta den. Du kan uppdatera databasen för mobila enheter på följande sätt:

  • Ersätt filen med den senaste versionen om du har en licens som tillåter den här användningen. Se Installera en annan WURFL-databas.
  • Använd den version som finns i AEM och konfigurera en regexp som matchar strängarna för användaragenten och pekar på en befintlig WURFL™-enhet. Se Lägga till en regexp-baserad användaragent-matchning.

Testa mappningen av en användaragent till WURFL™-funktioner

När en enhet kommer åt din mobila webbplats, identifierar AEM enheten, mappar den till en enhetsgrupp enligt dess funktioner och skickar en vy över sidan som motsvarar enhetsgruppen. Den matchande enhetsgruppen tillhandahåller nödvändig formatinformation. Mappningarna kan testas på testsidan för Mobile User-Agent:

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

Installera en annan WURFL™-databas

Den trunkerade WURFL™-databasen som installeras tillsammans med AEM är en release som innehåller fördatum
30 augusti 2011. Om din version av WURFL släpptes efter den 30 augusti 2011 kontrollerar du att din användning överensstämmer med din licens.

Så här installerar du en WURFL™-databas:

  1. Skapa följande mapp i CRXDE Lite: /apps/wcm/mobile/devicespecs
  2. Kopiera WURFL™-filen till mappen.
  3. Byt namn på filen till wurfl.xml.

AEM tolkar automatiskt filen wurfl.xml och uppdaterar noderna under /var/mobile/devicespecs.

OBSERVERA

När den fullständiga WURFL™-databasen är aktiverad kan det ta några minuter att analysera och aktivera. Du kan se loggarna för förloppsinformation.

Lägga till en regexp-baserad användaragent som matchar

Lägg till en användaragent som ett reguljärt uttryck nedan /apps/wcm/mobile/devicespecs/wurfl/regexp för att peka på en befintlig WURFL™-enhetstyp.

  1. I CRXDE Lite skapar du en nod under /apps/wcm/mobile/devicespecs/regexp, t.ex. apple_ipad_ver1.

  2. Lägg till följande egenskaper i noden:

    • regexp: reguljära uttryck som definierar användaragenter, t.ex.: .*Mozilla.*iPad.*AppleWebKit.Safari.
    • deviceId: det enhets-ID som definieras i wurfl.xml, t.ex.: apple_ipad_ver1

Ovanstående konfiguration gör att enheter som User-Agent matchar det angivna reguljära uttrycket mappas till Apple_ipad_ver1 WURFL™-enhets-ID, om det finns.

Identifiering av klientenhet

I det här avsnittet beskrivs hur du använder enhetsidentifieringen av AEM på klientsidan för att optimera sidåtergivningen eller för att förse klienten med alternativa webbplatsversioner.

AEM har stöd för enhetsidentifiering på klientsidan baserat på BrowserMap. BrowserMap levereras i AEM som ett klientbibliotek under /etc/clientlibs/browsermap.

BrowserMap innehåller tre strategier som du kan använda för att tillhandahålla en alternativ webbplats till en kund, som används i följande ordning:

  1. Alternativa länkar
  2. Enhetsgruppspecifik URL
  3. Väljarbaserad URL
OBSERVERA

Mer information om integrering av klientbibliotek finns i avsnittet Använda HTML-bibliotek på klientsidan.

OSGi-tjänsten PageVariantsProvider kan generera alternativa länkar för platser som tillhör samma familj. Om du vill konfigurera platser som ska beaktas av tjänsten måste en cq:siteVariant-nod läggas till i jcr:content-noden från platsens rot.

Noden cq:siteVariant måste ha följande egenskaper:

  • cq:childNodesMapTo - bestämmer vilket attribut för länkelementet som de underordnade noderna ska mappas till, Vi rekommenderar att du ordnar innehållet på din webbplats på ett sådant sätt att rotnodens underordnade objekt representerar roten för en språkvariant av din globala webbplats (t.ex. /content/mysite/en, /content/mysite/de), i vilket fall värdet på cq:childNodesMapTo priset ska vara hreflang.
  • cq:variantDomain - anger vilken Externalizer domän som kommer att användas för att generera sidvarianternas absoluta URL:er, Om detta värde inte anges genereras sidvarianterna med relativa länkar.
  • cq:variantFamily - anger vilken typ av webbplatser denna webbplats tillhör, Flera enhetsspecifika representationer av samma webbplats bör tillhöra samma familj.
  • media - lagrar värdena för länkelementets medieattribut, Vi rekommenderar att du använder namnet på den BrowserMap registrerade DeviceGroupsså att BrowserMap biblioteket automatiskt kan vidarebefordra klienterna till rätt variant av webbplatsen.

PageVariantsProvider och Externalizer

När värdet för egenskapen cq:variantDomain för en cq:siteVariant-nod inte är tomt kommer tjänsten PageVariantsProvider att generera absoluta länkar med det här värdet som en konfigurerad domän för tjänsten Externalizer. Se till att konfigurera Externalizer-tjänsten så att den återspeglar din konfiguration.

OBSERVERA

När du arbetar med AEM finns det flera metoder för att hantera konfigurationsinställningarna för sådana tjänster. Mer information och rekommenderade metoder finns i Konfigurera OSGi.

Definiera en enhetsgruppsspecifik URL

Om du inte vill använda alternativa länkar kan du konfigurera en global URL för varje DeviceGroup. Vi rekommenderar att du skapar ett eget klientbibliotek som bäddar in klientbiblioteket browsermap.standard men definierar om enhetsgrupperna.

BrowserMap är utformat på ett sådant sätt att definitioner för enhetsgrupper kan åsidosättas genom att skapa och lägga till en ny enhetsgrupp med samma namn till BrowserMap-objektet från ditt anpassade klientbibliotek.

OBSERVERA

Mer information finns i avsnittet Customized BrowserMap.

Definiera väljarbaserade URL:er

Om ingen av de tidigare funktionerna har använts för att ange en alternativ plats för BrowserMap, läggs väljare som ska använda namnen på DeviceGroups till i URLs, och i så fall bör du ange egna servrar som ska hantera förfrågningarna.

En enhetsbläddring www.example.com/index.html som identifieras som smartphone av BrowserMap vidarebefordras till www.example.com/index.smartphone.html.

Använda BrowserMap på dina sidor

Om du vill använda standardklientbiblioteket BrowserMap på en sida måste du inkludera filen /libs/wcm/core/browsermap/browsermap.jsp med en cq:includetagg i sidans head-avsnitt.

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

Förutom att lägga till BrowserMap-klientbiblioteket i dina JSP-filer måste du också lägga till en cq:deviceIdentificationMode String-egenskap som är inställd på client-side i jcr:content-noden under roten för din webbplats.

Åsidosätter BrowserMaps standardbeteende

Om du vill anpassa BrowserMap - genom att åsidosätta DeviceGroups eller lägga till fler avsökningar - bör du skapa ett eget klientbibliotek där du bäddar in browsermap.standardklientbiblioteket.

Du måste dessutom anropa metoden BrowserMap.forwardRequest() manuellt i din JavaScript-kod.

OBSERVERA

Mer information om integrering av klientbibliotek finns i avsnittet Använda HTML-bibliotek på klientsidan.

När du har skapat ditt anpassade BrowserMap-klientbibliotek föreslår vi följande tillvägagångssätt:

  1. Skapa en browsermap.jsp-fil i ditt program

    <%@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. Inkludera filen broswermap.jsp i huvudsektionen.

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

Exkluderar BrowserMap från vissa sidor

Om du vill utesluta BrowserMap-biblioteket från vissa sidor där du inte behöver någon klientidentifiering kan du lägga till ett request-attribut:

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

Detta gör att skriptet /libs/wcm/core/browsermap/browsermap.jsp lägger till en meta-tagg på sidan som gör att BrowserMap inte utför någon identifiering:

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

Testa en specifik version av en webbplats

Skriptet BrowserMap dirigerar normalt alltid om besökarna till den lämpligaste versionen av webbplatsen, och dirigerar vanligtvis om besökarna till skrivbordet eller till den mobila webbplatsen vid behov.

Du kan tvinga fram en enhet för en begäran för att testa en specifik version av en webbplats genom att lägga till parametern device i URL:en. Följande URL visar mobilversionen av Geometrixx Outdoors webbplats.

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

OBSERVERA

Parametern wcmmode är inställd på disabled för att simulera beteendet för en publiceringsinstans.

Det åsidosatta enhetsvärdet lagras i en cookie så att du kan bläddra på webbplatsen utan att lägga till parametern device i varje URL.

Därför måste du anropa samma URL med device inställt på browser för att komma tillbaka till skrivbordsversionen av webbplatsen.

OBSERVERA

BrowserMap lagrar det åsidosatta enhetsvärdet i en cookie med namnet BMAP_device. Om du tar bort den här cookien kommer CQ att fungera som den version av webbplatsen som passar din aktuella enhet (t.ex. dator eller mobil).

Bearbetning av mobilbegäran

AEM bearbetar en begäran från en mobil enhet som tillhör gruppen med pekenheter enligt följande:

  1. En iPad skickar en begäran till den AEM publiceringsinstansen, t.ex. https://localhost:4503/content/geometrixx_mobile/en/products.html

  2. AEM avgör om den begärda sidans webbplats är en mobilwebbplats (genom att kontrollera om förstanivåsidan /content/geometrixx_mobile utökar mobilsidans komponent). Om ja:

  3. AEM söker upp enhetsfunktionerna baserat på användaragenten i begärandehuvudet.

  4. AEM mappar enhetsfunktionerna till enhetsgruppen och anger touch som enhetsgruppsväljare.

  5. AEM dirigerar om begäran till https://localhost:4503/content/geometrixx_mobile/en/products.touch.html.

  6. AEM skickar svaret till iPad:

    • products.touch.html renderas på vanligt sätt och kan nås.
    • Återgivningskomponenterna använder väljare för att anpassa presentationen.
    • AEM lägger automatiskt till mobilväljaren till alla interna länkar på sidan.

Statistik

Du kan hämta statistik om antalet förfrågningar som gjorts till AEM av mobila enheter. Antalet begäranden kan delas upp:

  • per enhetsgrupp och enhet
  • per år, månad och dag

Så här visar du statistiken:

  1. Gå till konsolen Verktyg.
  2. Öppna sidan Enhetsstatistik nedan Verktyg > Mobil.
  3. Klicka på länken om du vill visa statistik för ett visst år, en viss månad eller en viss dag.

Sidan Statistik ser ut så här:

screen_shot_2012-02-01at24353pm

OBSERVERA

Sidan Statistik skapas första gången en mobil enhet öppnar AEM och identifieras. Den är inte tillgänglig tidigare.

Om du behöver generera en post i statistiken kan du göra så här:

  1. Använd en mobil enhet eller en emulator (till exempel https://chrispederick.com/work/user-agent-switcher/ i Firefox).
  2. Begär en mobilsida på författarinstansen genom att inaktivera redigeringsläget, t.ex.:
    https://localhost:4502/content/geometrixx_mobile/en/products.html?wcmmode=disabled

Sidan Statistik är nu tillgänglig.

Mobilsidor kan vanligtvis nås via Dispatcher, eftersom sidor som återges för en enhetsgrupp särskiljs i sidans URL av enhetsgruppsväljaren, till exempel /content/mobilepage.touch.html. En begäran till en mobilsida utan väljare cachelagras aldrig, som i det här fallet utförs enhetsidentifieringen och dirigeras till den matchande enhetsgruppen (eller"nominatch" för den delen). En mobilsida som återges med en enhetsgruppsväljare bearbetas av länkomskrivaren, som skriver om alla länkar på sidan så att de även innehåller enhetsgruppsväljaren, vilket förhindrar att enhetsidentifiering utförs på nytt varje gång du klickar på en redan kvalificerad sida.

Därför kan du stöta på följande scenario:

Användare Alice omdirigeras till coolpage.feature.html och skickar den URL:en till en vän Bob som kommer åt den med en annan klient som ingår i enhetsgruppen touch.

Om coolpage.feature.html hanteras från ett klientcache-minne får AEM inte möjlighet att analysera begäran för att ta reda på att mobilväljaren inte matchar den nya användaragenten och Bob får fel representation.

Du kan lösa det genom att ta med ett enkelt markeringsgränssnitt på sidorna, där slutanvändarna kan åsidosätta enhetsgruppen som markerats av AEM. I exemplet ovan kan slutanvändaren växla till coolpage.touch.html om han anser att den här enheten är tillräckligt bra för det genom en länk (eller en ikon) på sidan.

På denna sida