Documentatie Joomla! extensie ’Attachments’

Version 1.2 - 20 Februari 2008

Nederlandse vertaling door Parvus

  1. Inleiding
  2. Beperkingen
  3. Instellingen
  4. Bestandsnamen
  5. De lijst van bijlagen opmaken
  6. Pictogrammen
  7. Tips
  8. Upgraden
  9. Dankwoord

Inleiding

Met de Joomla! extensie ’Attachments’ kan u bestanden als bijlage aan een artikel toevoegen. ’Attachments’ bevat twee plugins en een component. De plugins laten u toe bijlagen te tonen en toe te voegen; de component verzorgt zowel het verzenden van bestanden van uw PC naar de webserver als het beheer van de reeds verzonden bestanden op de webserver. Verschillende opties zorgen voor de nodige flexibiliteit en verhogen het gebruiksgemak. U kan ook zelf bepalen wie de bijlagen kan openen en wie bijlagen aan een artikel kan toevoegen. Alle opties zijn in te stellen in de component Artikel Bijlagen in de back-end.

’Attachments’ is alleen geschikt voor Joomla! 1.5 of hoger.

’Attachments’ kan gemakkelijk worden vertaald naar je eigen taal. De volgende talen zijn reeds beschikbaar: Een woord van dank aan alle vertalers! Als u wilt helpen om uw eigen taal toe te voegen of te verbeteren, aarzel dan niet en neem contact op met Jonathan M. Cameron. [Index]

Beperkingen

Niet alle bestanden kunnen verzonden worden naar de webserver. ’Attachments’ weigert bestanden die niet zijn toegelaten door de Media instellingen. Deze zijn terug te vinden in de back-end via Algemene instellingen in de tab systeem (u heeft hier wel super-administrator rechten voor nodig). U kan daar de toegestane bestandstypen en MIME typen voor media bestanden inkijken en aanpassen. ’Attachments’ respecteert al deze instellingen, alleen de instelling Toegestane afbeeldingsextensies (bestandstypen) wordt genegeerd. [Index]

Instellingen

Alle instellingen voor ’Attachments’ zijn ondergebracht bij de component Artikel Bijlagen. Deze zijn terug te vinden in de back-end via pluginbeheer onder het menu Extensies. Kies daarna voor het bewerken van de plugin Content-Attachments. Aan de rechterkant van de pagina vindt u dan de lijst van instellingen. [Index]

Bestandsnamen

Standaard wordt de volledige bestandsnaam getoond in de lijst van bijlagen als link om het bestand af te halen. Indien gewenst kan u in het veld Toon bestandsnaam een andere naam of label opgeven die getoon moet worden in plaats van de volledige bestandsnaam. Dit kan ook aangepast worden in de back-end.
Indien de bestandsnamen te lang zijn, kan de tabel van bijlagen niet netjes worden getoond. U kan een bestandsnaam automatisch afkorten met de plugin optie Maximum lengte van de bestandsnaam. Dit heeft geen invloed op de naam waaronder ze worden bewaard: de naam wordt dan alleen verkort weergegeven. De waarde 0 schakelt het inkorten uit: de lengte wordt dan niet beperkt. [Back to top]

De lijst van bijlagen opmaken

De lijst van bijlagen die getoond worden bij een artikel maken gebruik van een specifieke div die een tabel bevat. Met deze tabel zijn een aantal CSS classes geassocieerd, om een administrator de flexibiliteit te geven de opmaak van de tabel aan te passen aan ieders eigen noden en wensen.
In de plugin van ’Attachments’ kan u een css bestand vinden waar de css class definitie terug te vinden is, zie ./plugins/content/attachments.css. Om een eigen opmaak op te stellen, vertrekt u best van het voorbeeld wat u daar vindt. Het is ten sterkste aangeraden om de css class attachmentsList eerst te kopieren, dan te hernoemen, om tenslotte in de nieuwe css class uw wijzigingen aan te brengen.
In de component Artikel Bijlagen in de back-end kan u bij de instelling Attachments table style uw nieuwe css class opgeven. Als u de raadgeving hierboven opvolgt, is het gemakkelijk om terug te gaan naar de originele - en gegarandeerd werkende - toestand. U kan ook de css instructie @import gebruiken; dit maakt het gemakkelijker om een overzicht te bewaren over alle wijzigingen en bij een upgrade deze opnieuw aan te brengen.
[Index]

Pictogrammen

’Attachments’ toont een pictogram bij elke bestand in de lijst van bijlagen. U kan aangeven welk pictogram u wenst te gebruiken voor een bepaald bestandstype: [Index]

Tips

[Index]

Upgraden

Indien u al bestanden heeft toegevoegd aan artikels, voor de installatie van een nieuwe versie, kunt u het volgende doen om deze bijlagen te behouden:
Merk op dat het deïnstalleren van de ’Attachments’ extensie de bestanden zelf in de bijlage folder niet verwijderd, alleen de referenties er naar in de database. Alle referenties naar die bestanden worden bewaard in de tabel jos_attachments.

Het kan ook zijn dat u niet wil dat tabel in de database weer hersteld wordt. De bijhorende bestanden zitten dan nog steeds in uw bijlage folder zitten. Vergeet dan zeker niet deze te verwijderen. [Index]

Dankwoord

Een woord van dank aan: [Back to top]
 
Fouten, opmerkingen en suggesties worden graag behandeld door jmcameron@jmcameron.net.