Men min avsikt är inte att gnälla, Alfresco har att se helheten och sätta prioriteringen. Och eftersom det är en öppen-källkodsprodukt så kan du om du inte är nöjd med hur något fungerar, fixa eller förbättra det. Så det har jag gjort. Jag har tagit fram en alternativ dokumentvisare baserad på Mozilla projektet pdf.js.

Alla dokument som visas i den flashbaserade dokumentvisaren måste transformeras i kedjan <source format> - <pdf> - <flash>. Om vi kan skippa det sista steget så kan vi undvika pdf2swf och risken för en jvm krash. Och vi kommer stödja samma format som nu. Men då måste det finnas ett sätt att visa pdf-filer direkt i webbläsaren. Chrome och Safari kommer med en pdf-visare inbyggd, så den kan vi använda. Och många andra har en extern plugin såsom Acrobat reader installerad. Vilket kommer att täcka väldigt många användare, men det bästa vore om det gick att visa pdf-filer direkt i webbläsaren. Och det är vad pdf.js gör, allt implementerat i Javascript med hjälp av html5.

Så dokumentvisaren jag tagit fram försöker

• Använda pdf.js visare för webbläsare som stödjer html5
• Om pdf.js inte kan användas, försök och se om en pdf plugin är installerad och visa pdf-filen med den.
• Som sista alternativ, använd standard Alfresco flash based dokumentvisare.

Det enklaste sättet att göra detta var att använda <iframe>, där pdf.js visaren laddas via en Alfresco surf sida som implementerar pdf.js standard visare i stort sett ‘out of the box’. Du kan testa standard visaren här here. Den är väldigt funktionell, och de flesta pdf-filer jag testat visas utan problem.

Samma metod med att använda iframe används för att visa pdf med en extern pdf-tillägg. Genom att sätta src i iframe så starts tillägget.

Så här ser det ut

www.youtube.com/watch?v=V1R08Ba3uo4

Jag tänker släppa källkoden inom kort, den måste bara justeras lite. Jag uppdaterar inlägget när jag är klar med det.

Uppdatering
Källkoden är incheckad Share Extras projektet. Du kan se koden här.
Det finns ingen kompilerad version ännu, vilket är med avsikt, Det är fortfarande otestad, men om du vet hur du checkar ut och komplilerar så antar jag att du inte rusar iväg och använder det på en produktionsserver.

Detta är en mycket trevlig funktion, som bara fungerar. Men det finns några problem med detta. För det första så finns det ingen indikation i Share formulär att detta sker, det bör åtminstone vara en visuell indikation på att det sker. Andra problemet är att titel och egenskaper beskrivning inte bara används för dokument, det används för många andra komponenter i Alfresco. Jag har gjort några tester, och jag har funnit att webbplatsens namn och beskrivning, Blogginlägg titel, diskussion ämnesrubrik, Data List namn och beskrivning, och Data List rad namn och beskrivning kommer att visa olika texter beroende på språk om den har redigerats med olika språkpreferenser i webbläsaren. Återigen detta händer bara om egenskaperna redigeras med ett annat språk, förmodligen inte händer så många gånger att en diskussion redigeras med olika språkinställningar, men att Webbplatsansvariga från olika länder ändrar webbplatsens rubrik och beskrivning är inte osannolikt.

Det var en kund till mig som först upptäckte detta beteende, och jag registrerade en bugg ALF-3756 i juli 2010. Min första reaktion var att användarna inte ska se olika saker, och att det var på grund av att användare använde olika webbläsare, och att detta skulle fixas. Som det visar sig, är det inte på grund av olika webbläsare, utan det är det på grund av olika språkinställningar i olika webbläsare. Det har nyligen fixats i HEAD källkoden, så jag testar med förhoppningen att det är fixat, men ingenting hade förändrats och beteendet är detsamma. Så jag anmälde en ALF-11166 , men efter att funderat lite på flerspråkiga beteende, så harjag kommit fram till att det inte är en bugg trots allt, och det är därför jag skriver det här inlägget.

Jag har tänkt på olika sätt att fixa detta, kunde vara att du ändrar egenskapen definitionen av cm:title och cm:description i datamodellen från d:mltext till d:text. Vissa begränsade tester visar att denna fix kommer en egenskap fortsätta vara flerspråkig (d: mltext) till nästa redigering, då det sparas som d:text, och alla användare kommer se samma sak oberoende av språk. Ändra i standardmodellen är inget jag rekommenderar, och jag gjorde bara en mycket begränsad test för att se vad som hände. Och det är nog inte rätt sätt att fixa detta, eftersom det tar bort en mycket bra funktion. Alfresco hanterar flerspråkighet (I18N) mycket bra, och nästan allt är lokaliserat, och från 4.0 egenskapslistor (constraints) möjliga att ha på flera språk. Så det faktum att man kan ha webbplatsens titel och beskrivning på olika språk är en bra sak.

Så rätt fix för detta är att visuellt visa vad som händer i alla formulär och dialogrutor. Det kan genomföras i steg om inte den fullständiga metoden kan tas på en gång

1. Skapa en kontroll med flagga som motsvarar de som visar vilket soråk som används, så att du visuellt se vad språket som för närvarande redigeras.
2. Ändra i kontrollen så att du kan lista andra värden för att se basspråket och de aktuella värdena för övriga språk. Så att du kan hålla reda på översättningar och hålla dem i synk.

Jag skapade (eller egentligen uppdaterade befintliga textkontroller) och då ser det ut så här för flerspråkig egenskaper

Fullständig information om hur jag gjorde detta är frågan ALF-11166. Det är ett litet första steg fixat genom att redigera freemarker mallen för textkontrollen, en mer komplett lösning som jag beskrev är möjligheten att lista alla värden för olika språk. Låt mig veta vad du tycker.

Det här inlägget visar hur du kan göra det, och också hur du kan använda de inbyggda mallarna (tillgängliga från 4.0.b), och den nya Surf extension mekanismen.


Alla sökvägar som anges nedan är class path relativa, om du redigerar direkt kan du använda tomcat/shared/classes/alfresco.
Starta genom att skapa en nu sida i site-data/pages kallad appintegrator.xml med innehåll

<?xml version='1.0' encoding='UTF-8'?>
<page>
	<title>Application</title>
	<description>Application</description>
	<template-instance>1-column</template-instance>
	<authentication>user</authentication>
	<components>

		<!-- Top -->
		<component>
			<region-id>title</region-id>
			<sub-components>
				<sub-component id="appintegratortitle">
					<url>/components/title/simple-title</url>
					<properties>
						<title>Application</title>
					</properties>
				</sub-component>
			</sub-components>
		</component>

		<!-- Column -->
		<component>
			<region-id>column</region-id>
			<sub-components>
				<sub-component id="appintegratoriframe">
					<url>/components/appintegrator/iframe</url>
				</sub-component>
			</sub-components>
		</component>
	</components>
</page>

Som du kan se använder den sig av en template instance som heter 1-column, en av de out of the box mallarna som finns från 4.0.b så att vi inte behöver skapa egna mallar för vår nya sida. Erik Winlöf har skrivit mer hur du använder out-of-the-box mallar om du vill lära dig mer.
Den första komponenten i våran nya sida är en out of the box komponent i Alfresco som vi använder för att skapa en titelrad. Nästa komponent är ny och som vi skapar för att rendera vår iframe. Börja med att skapa filer i site-webscripts/org/alfresco/components/appintegrator
iframe.get.desc.xml

<webscript>
  <shortname>appintegratoriframe</shortname>
  <description>Application Integrator iFrame</description>
  <url>/components/appintegrator/iframe</url>
</webscript>

iframe.get.html.ftl

<iframe id="${args.htmlid}-appintegrator" src="${protocol}${iurl}" scrolling="no"
marginwidth="0" marginheight="0" frameborder="0" vspace="0" hspace="0"
style="overflow:visible; width:100%; height:5000px"></iframe>

iframe.get.js

//The url argument is called iurl because there is a built in url object in Surf
var iurl = page.url.args.iurl !== null ? decodeURIComponent(page.url.args.iurl)
		: "loftux.se";
var ssl = page.url.args.ssl !== null ? decodeURIComponent(page.url.args.ssl)
		: "false";

if (ssl==="true") {
	model.protocol="https://";
}else{
	model.protocol="http://";
}
model.iurl=iurl;

Starta om Share, och nu skall du kunna navigera till http://localhost:8080/share/page/appintegrator?iurl=loftux.se&ssl=false. Som du kan se är det två argument, iurl är den url som du vill iframe skall ladda, och ssl true/false sätter protokollet till respektive https/http (du skall alltså inte ha med det i iurl).
Bara att sätta igång att lägga till länkar i Share Header, och du har alla dina webbapplikationer bekvämt samlade på ett ställe.

Men titelraden kunde gott ge lite mer information än bara ‘Application’, till exempel namnet och en beskrivning av den applikationen som för närvarande är laddad i iframe. Eftersom vi vill länka från Share Header, så vill vi skicka den informationen som argument i url:en. För det skapar vi en ny title component, skapa den i site-webscripts/org/alfresco/components/appintegrator. Den är väldigt lik originalet, bara ändrad så att den kan ladda argument från url:en.
appintegrator-title.get.desc.xml

<webscript>
  <shortname>Simple Title</shortname>
  <description>Simple generic title component that displays the title using the message keys passed in as url arguments</description>
  <url>/components/appintegrator/appintegrator-title</url>
</webscript>

appintegrator-title.get.html.ftl

<div class="page-title theme-bg-color-1 theme-border-1">
   <h1 class="theme-color-3"><span><#if page.url.args.title??>${page.url.args.title}</#if></span>
   <#if page.url.args.subtitle??>${page.url.args.subtitle}</#if></h1>
</div>

För att ladda denna komponent, det ”gamla” sättet att göra detta vore att redigera mallen. Men eftersom vi använder out of the box mallar, så kan vi inte ändra dem. Men för 4.0 så finns en ny extension mekanism, som vi kan använda för att enkelt ersätta den existerande komponentet med vår egen utan att ändra mallen. För detaljer kring detta läs, read David Drapers blogg (första inlägget i en serie).

Så i site-data/extension lägger vi till filen
appintegrator.xml

<extension>
  <modules>
   <module>
   <id>Loftux AppIntegrator</id>
   <components>
     <component>
	<region-id>title</region-id>
	<source-id>appintegrator</source-id>
	<scope>page</scope>
	<sub-components>
	  <!-- Remove default title -->
	  <sub-component id="appintegratortitle">
	    <evaluations>
	      <evaluation id="hidedefaulttitle">
	        <render>false</render>
	      </evaluation>
	    </evaluations>
	  </sub-component>
	  <!-- Add our new title -->
	  <sub-component id="appintegratortitlenew">
	    <url>/components/appintegrator/appintegrator-title</url>
	  </sub-component>
	</sub-components>
      </component>
     </components>
    </module>
  </modules>
</extension>

Jag kommer inte gå in på detaljer för hur du hittar region-id, source-id och component id, för det rekommenderar jag Davids inlägg. Vad vi gör är att säga till Share att inte rendera ‘simple-title’ komponententen, här med namnet appintegratortitle, och iställer rendera vår egen title component. För att detta skall ta effekt, gå till http://localhost:8080/share/page/modules/deploy och gör aktivera (deploy) på Loftux Appintegrator modulen.

När vår tilläggsmodul är aktiverad, så kan vi lägga till två nya argument till url:en, title och subtitle som kommer visas i titelraden. Ingen av dem är obligatoriska, bara att använda dem du har behov av.
Din slutliga konfiguration för Share Header kan se ut ungefär så här (utdrag)

<item type="container" id="application" icon="appintegrator.png">
   <container-group id="my" label="Internal Applications">
      <item type="link" id="loftuxse" icon="appintegratorwindow.png" label="Loftux.se" description="Dokument och informationshantering"><![CDATA[/appintegrator?title=Loftux.se&subtitle=Dokumenthantering&iurl=loftux.se]]></item>
      <item type="link" id="loftuxcom" icon="appintegratorwindow.png" label="Loftux.com" description="Document and Information management"><![CDATA[/appintegrator?title=Loftux.com&subtitle=Document%20management&iurl=loftux.com]]></item>
      <item type="external-link" id="devcona" icon="appintegratorsplash.png" label="DevCon Americas" description="Alfresco DevCon Americas"><![CDATA[/appintegrator?title=Alfresco DevCon&subtitle=Americas&iurl=www.amiando.com/alfresco-devcon-san-diego-2011.html]]></item>
      <item type="external-link" id="devcone" icon="appintegratorstar.png" label="DevCon EMEA APAC" description="Alfresco DevCon EMEA APAC"><![CDATA[/appintegrator?title=Alfresco DevCon&subtitle=EMEA%20APAC&iurl=www.amiando.com/alfresco-devcon-london-2011.html]]></item>
   </container-group>
</item>

Detta renderar meny som visas i första bilden. Notera att du kan skapa länkar som visas i aktuellt fönster eller i nytt fönster/flik. Eftersom applikationerna ligger i en iframe så måste användare kunna surfa direkt till dem, så det lämpar sig inte när Share klienten ligger utanför brandväggen.

För det här Share tillägget kanske det hade varit enklare att skapa en egen template till vår iframe page. Då hade vi inte behövt använda Surf Extensions, men jag tror det kan vara ett bra exempel på hur du kan använda de nya funktionerna för tillägg i Share
Du kan ladda ner färdig kompilerad jar, konfiguration och all källkod här AppIntegrator.

Det tar bort alla länkar till sidan, men som den erfarna Alfresco användaren du är så vet du att du fortfarande kan komma åt sidan genom att skriva den kompletta url:en till sidan, för repository är den /share/page/repository. Och det här är något du vill inaktivera.

Det är faktiskt enkelt att göra, url:en kommer fortfarande vara tillgänglig, men sidan visar inget annat än verktygsraden och ett meddelande.

Börja med att lägga till i
tomcat/shared/classes/alfresco/web-extension/
de här mapparna och undermappar
site-data/pages
site-data/template-instances
templates
Vad du vill göra är att hitta definitionsfilen för den sida som du vill inaktivera och kopiera till site-data/pages. För sidan som används i det här exemplet, repository, är det tomcat/webapps/share/WEB-INF/classes/alfresco/site-data/pages/repository.xml
Efter kopiering, redigera sidan så att den ser ut så här

<?xml version='1.0' encoding='UTF-8'?>
<page>
   <title>Repository Browser</title>
   <title-id>page.repository.title</title-id>
   <description>Browse content across the whole Repository</description>
   <description-id>page.repository.description</description-id>
   <template-instance>disabled</template-instance>
   <authentication>user</authentication>
</page>

Den viktiga ändringen här är <template-instance>disabled</template-instance>, vi säger till sidan att använda en ny mall, som vi nu måste skapa.
Skapa filen site-data/template-instances/disabled.xml med innehåll

<?xml version='1.0' encoding='UTF-8'?>
<?xml version='1.0' encoding='UTF-8'?>
<template-instance>
   <template-type>disabled</template-type>
</template-instance>

och den faktiska mallfilen site-data/templates/disabled.ftl med innehåll

<#include "/org/alfresco/include/alfresco-template.ftl" />
<@templateHeader />

<@templateBody>
   <div id="alf-hd">
      <@region id="header" scope="global" protected=true />
   </div>
<hr/>
This page is not available.
</@>

<@templateFooter>
   <div id="alf-ft">
      <@region id="footer" scope="global" protected=true />
   </div>
</@>

Du kan naturligtvis lämna vilket meddelande du vill.
Ladd om webscripten eller start om din server, och sidan är inaktiverad.
För varje ytterligare sida som du vill inaktivera så kan du återanvända mallen. Allt du behöver göra är första steget att kopiera definitionsfilen för sida, och ändra referensen till den nya sida. För att vet vilken fil det är, navigera till den sidan som du vill inaktivera, det som står efter /page/ är oftast lika med deinitionsfilen med filändelsen xml.

Och naturligtvis går detta att göra mer avancerat så som att lägga till response status 404, lägga till I18N stöd, eller inludera component webscripts. Men det här är en bit på vägen.

Funktionalitet

• All standardfunktionalitet i CKEditor.
• Anpassade konfigurationsfiler
• Infoga bildfiler direkt från Alfresco Share webbplats.

För formulär i Alfresco är det enkelt att skapa nya kontroller. I detta fall så anger du bara att du vill använda den nya kontrollen enligt

<appearance>
   <field id="cm:content">
      <control template="/org/alfresco/components/form/controls/ckeditor.ftl">
         <control-param name="forceEditor">true</control-param>
      </control>
   </field>
</appearance>

Själva kontrollen inklusive källkod ladda ner från Share Extras projektet. Mer om hur du konfigurerar formulär på Alfresco Wiki
För att installera, kopiera filen ckeditor-form-control-0.1.jar till tomcat/webapps/share/WEB-INF/lib. Sedan ändrar du dina formulärdefinitioner enligt ovan eller kopierar filen ckeditor-config-custom.xml (ta bort filändelsen sample) till tomcat/shared/classes/alfresco/web-extension och startar om.

Vill du använda en anpassad konfigurationsfil för att ange vilka knappar som visas och styra utseende så kan du ange vilken med

<control-param name="settingsfile">components/editors/ckeditor/my-config.js</control-param>

Sökvägen skall vara utan inledande / och sedan till den plats där du placerat filen. Om du skapar en bra config fil så inkluderar jag den gärna om du skickar den till mig. Kommer framöver lägga till några alternativa konfigurationsfiler.

För att bläddra efter bilder så klickar du bara ”bläddra på server” så listas miniatyrbilder. Jag baserade den på Image dashleten som finns i Share, så naturligtvis kan du klicka på bilden och få en full förhandsgrandskning. Välj en bild genom att klicka namnet.

Mallen som används finns sparad i Arkiv> Data Dictionary> Email Templates> invite och heter invite-email.ftl. Du når den alltså genom att i Alfresco Share klicka på knappen Arkiv (Repository) i verktygsraden, och sedan bläddra dig fram till invite-email.ftl. Du kan redigera den direkt i webbläsaren om du vill. Enkla saker vi kan göra här är naturligtvis att översätta allt till svenska, och ändra avsändare.

Den bekräftelselänk som skapas sätter servernamnet till den server som den som bjuder in använder. Det är i det allra flesta fall alldeles tillräckligt, men av olika skäl så kanske du vill dirigera interna och externa användare till olika servers. Du kanske har satt upp olika autentiseringsmetoder för interna och externa användare, eller att du anpassat den externa Share instansen för just externa användare.
http://alfresco.example.com/share/page/accept-invite?inviteId=jbpm$156&inviteeUserName=peter%40example.com&siteShortName=mysite&inviteTicket=610b4819-0153-4406-9d85-0357e5ee65d3
Exemplet ovan visar hur länken för inbjudan kan se ut, i exemplet så kommer alfresco.example.com från den server som personen som bjudit in använt. Vi vill dock att alla externa användare skall slussas till alfresco-external.example.com. Det kan vi enkelt göra med lite freemarker kod. Har du aldrig använt detta tidigare skall du inte se det som ett stor hinder, kan du lite html och/eller javascript går det lätt att förstå, och freemarker är väl dokumenterat.

Så här kan mallen se ut, jag har skrivit kommentarer inline för att förklara.

<#assign inviterPersonRef=args["inviterPersonRef"]/>
<#assign inviterPerson=companyhome.nodeByReference[inviterPersonRef]/>
<#assign inviteePersonRef=args["inviteePersonRef"]/>
<#assign inviteePerson=companyhome.nodeByReference[inviteePersonRef]/>
<#-- Ta bort servernamnet ur länken-->
<#assign jaLink=args["acceptLink"]?substring(args["acceptLink"]?index_of("/share")) />
<#assign nejLink=args["rejectLink"]?substring(args["rejectLink"]?index_of("/share")) />
<#assign userName=args["inviteeUserName"]?string />
<#-- Sätt servernamn beroende på om användare är extern eller intern -->
<#if userName?index_of("@") &gt; 0 >
<#-- Alla externa användare har epostadress som användarnamn, kolla efter detta -->
    <#assign serverName="http://alfresco-external.example.com" />
<#else>
    <#assign serverName="https://alfresco.example.com" />
</#if>

Hej ${inviteePerson.properties["cm:firstName"]},

Du har blivit inbjuden av ${inviterPerson.properties["cm:firstName"]} ${inviterPerson.properties["cm:lastName"]} att deltaga i webbplatsen '${args["siteName"]}'.

Din roll i webbplatsen kommer vara ${args["inviteeSiteRole"]}.

För att acceptera inbjudan klicka länken nedan
<#-- Sätt ihop servernamnsom är olika beroende på om det är extern eller intern användare med ja-länk -->
${serverName}${jaLink}

<#if args["inviteeGenPassword"]?exists>
och ange följande information:

Användarnamn: ${args["inviteeUserName"]}
Lösenord: ${args["inviteeGenPassword"]}

Det rekommenderas starkt att du byter lösenord direkt efter inloggning via 'Min profil'.

</#if>
Om du inte vill bli medlem i webbplatsen klicka:
<#-- Sätt ihop servernamn med nej-länk -->
${serverName}${nejLink}

Sätt ett bokmärke till servern när du skall logga in nästa gång
${serverName} <#-- Denna är viktig, många användare missar var de skall gå efter att de väl accepterat första gången -->
Du kan även skapa bokmärken för andra platser i Alfresco Share om du vill nå en plats snabbt.

Med vänlig hälsning

${inviterPerson.properties["cm:firstName"]} ${inviterPerson.properties["cm:lastName"]}
Företaget AB

Notera att du nu kan lägga in en länk till själva servern. Jag har märkt att det ibland uppstår lite förvirring var användaren skall navigera efter att de accepterat en inbjudan. Ofta letar de upp epostmeddelandet igen, och klickar den enda länk de hittar, men får då ett felmeddelande eftersom de redan accepterat inbjudan. Tyvärr stöds inte html formaterade epostmeddelande av Alfresco än så det utgående meddelandet blir formaterat i ren text.
Ett annat tips kan vara att lägga in en länk till en hjälpsida i wiki (om din hjälpasida heter Getting Started)
${serverName}/share/page/site/publicsitename/wiki-page?title=Getting_Started
Det måste dock vara en länk till en site som är publik, så att alla har läsrättigheter.

Jag har konfigurerat om Alfresco så externa användarid skapas som epostadress. Det gör du genom att skapa en fil i tomcat/shared/classes/alfresco/extension som heter invite-context.xml med innehållet

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE beans PUBLIC '-//SPRING//DTD BEAN//EN' 'http://www.springframework.org/dtd/spring-beans.dtd'>
<beans>
    <bean id="nameBasedUserNameGenerator" class="org.alfresco.repo.security.authentication.NameBasedUserNameGenerator">
            <!-- name patterns available:
       		%lastName%,  lower case last name
       		%firstName%, lower case first name
       		%emailAddress% email address
           	%i% lower case first name inital
     		-->
        <property name="namePattern">
        	<value>%emailAddress%</value>
        </property>
        <property name="userNameLength">
            <value>10</value>
        </property>
    </bean>
</beans>

Det går även bra att lägga till fast text, till exempel om du vill att alla skall ha ett prefix ext så använder du ext_%firstName%_%lastName%.

Hoppas detta gett lite idéer om vad du kan göra. Det går naturligtvis göra mycket mer, exempel kan vara att lägga in länkar till support, länkar till sökningar, lägga in texten på flera språk med mera. Eftersom detta meddelande är det första många användare möter så är det värt att arbeta lite med mallen. Lyckat till.

Den första versionen är inte konfigurerbar, och tog bara namnet på webbplatsen (siten), och visar vad som indexerats av Google baserat på webbplatsens namn. Och därav kommer namnet på dashleten, det är nyheter kring din webbplats som visas. Det fungerade som exempel på hur du kan skapa en dashlet, men för att verkligen komma till nytta så behövs möjligheten att konfigurera dashleten med anpassade sökningar.

Den version som nu finns att ladda ner från Share Extras har fått möjlighet till att anpassa sökfrågan (standard om du inte konfigurerar är fortfarande webbplatsens namn). Du kan använda alla de sökalternativ som du använder vid en normal google sökning för att få en bättre träffbild. Du kan även ange antal dagar bakåt i tiden som sökningen skall göras. Med hjälp av drag och släpp kan du även ange vilka sökningar (flikar) som kommer att visas, och i vilken ordning de visas.

Ladda ner. Instruktioner.

Ladda ner jar filen, färdigkompilerad för att läggas till i Share (se instruktioner). Eller ladda ner källkoden för att skapa din egen variant. Om du vill får du gärna bidra med översättningar till andra språk (just nu finns den på engelska och svenska). Eller så kanske du har en helt egen Share komponent du vill del med dig av till Alfresco Comunityt?