Package: collective.tinymceplugins.advfilelinks
Table of contentsIntroductionDetailed documentationCustomize format of link to contentsExtending for custom contentsDependenciesInternet Explorer 9 usersCreditsAuthorsChangelog1.3.2 (2014-12-10)1.3.1 (2014-06-20)1.3.0 (2014-05-27)1.2.1 (2013-09-18)1.2.0 (2013-02-27)1.1.0 (2012-12-05)1.0.0 (2012-10-10)0.2.1 (2012-04-20)0.2.0 (2012-04-20)0.1.0 (2011-10-13)0.0.1alpha (2010-07-20)IntroductionThis is a plugin forTinyMCEeditor for Plone.It will replace in the less obtrusive way the standardplonelinkplugin, providing a version that
handle in a different way links to File and Image contents.Detailed documentationWhen the link is not internal or not to a file nothing will change and standard Plone behavior is kept.When you link afileor animageinside the Plone site you commonly get this XHTML code…:<a class="internal-link" href="my-pdf">Download the document</a>Instead you’ll get this…:<a class="internal-link internal-link-tofile" href="my-pdf"
   type="application/pdf" title="pdf, 146.2 kB">Download the document</a>(the same if you have enabled “Link using UIDs”)The plugin also add a CSS to your Plone site that:Add the image icon based on file’s mimetype, on the left of the link (if on IE, need IE 7 or better)After the linked text will be added atext generated with CSS, with the same content you find in thetitle, put in bracket (need IE 8 or better).
IE users with old versions still get’s some additional information thanks to thetitleHTML attribute.How a normal page looks likeWhat you will find inside TinyMCECustomize format of link to contentsPlone normally doesn’t manage link to file is special ways (it simply generate a link to the base URL of
the content).This plugin will add a new control inside advanced settings:The “Link format” option, inside advanced settingsPlaying with those options can change the format of the generated link, adding a suffix to it.Direct link to content(TinyMCE default)Do not add any suffix.Link to content’s preview(default forImage)A link to a view of the contentLink to download content(default forFile)Force the download of the file (or image)Most of the time “Link to download content” is like “Direct link to content”: callingurl/to/a/fileis like
callingurl/to/a/file/at_download/file, but without an explicitat_download/filesometimes the target file
can be opened by browser plugins (expecially common for images, whereurl/to/an/imagewill open the image in
the browser).The “Link to content’ preview” can ne used to create links that are not opening the attachment, but move user to
the Plone content.Extending for custom contentsLet say you are using a new Plone content type, like a Video. You want that TinyMCE links to video contents in a
custom way.What you need is to provide a new adapter for theIFileSuffixesinterface:<adapter
      for="your.package.content.IYourVideoType
           zope.publisher.interfaces.browser.IHTTPRequest"
      provides="collective.tinymceplugins.advfilelinks.interfaces.IFileSuffixes"
      factory=".adapters.YourVideoTypeDownloadSuffix"
      />The provide the Python adapter code:class YourVideoTypeDownloadSuffix(object):
    implements(IFileSuffixes)

    def __init__(self, context, request):
        self.context = context
        self.request = request
        self.download_suffix = '/video_download'
        self.view_suffix = '/preview_video'
        self.default_suffix = 2You can provide three options:download_suffixProvide the suffix to be added when using “Link to download content”
for your content.Set the value toNoneand no suffix wil be added or usedview_suffixProvide the suffix to be added when using “Link to content’s preview”
for your content.Set the value toNoneand no suffix wil be added or useddefault_suffixProvide ad integer value to be used for settings the default combo box option.
Use 1 for the first combo option, 2 for the second, and so on.You can use this feature also for overriding default behavior for File and Image contents.DependenciesThis product has been tested with:Plone 3.3.5 and TinyMCE 1.1.12Plone 4.2.4 and TinyMCE 1.2.15WarningThis product willnot workon Plone 4.3 or on every other Plone versions that use
Products.TinyMCE 1.3 or better. Sorry… maybe in future!Why? Products.TinyMCE 1.3 has been rewritten from scratch.Internet Explorer 9 usersProducts.TinyMCE 1.2 and below suffer of knows problems with IE version 9 (and above).
Those problems have ben fixed in Products.TinyMCE 1.3 but, as said above, this plugin will
not work on version 1.3.Instead of upgrade you can then apply one of theknows workarounds.CreditsDeveloped with the support ofRegione Emilia Romagna;
Regione Emilia Romagna supports thePloneGov initiative.AuthorsThis product was developed by RedTurtle Technology team.Thanks to theUniversity of Ferrarafor providing CSS rules to be more compatible with additional
mimetypes.Changelog1.3.2 (2014-12-10)Ported a bugfix closed in the original TinyMCE file plugin.
See@0082163c6d[keul]1.3.1 (2014-06-20)Fixed CSV icon (similar topull request #2on collective.mtrsetup)
and setted as non-binary
[keul]Support forodpfile
[keul]Changed icon forzipandrar[keul]1.3.0 (2014-05-27)Now depends oncollective.mtrsetupto support also
a lot of additional mime types [keul]New CSV support [giacomos, keul]Default icon for unknow file [giacomos, keul]1.2.1 (2013-09-18)Fixed a JavaScript error when referencing non-file contents [keul]Do not display the additional file’s information when not referencing file
types [keul]1.2.0 (2013-02-27)Restored the default TinyMCE link suffix as default [keul]Added a new adapter option:default_suffix, to be able to
control link type defaul by type [keul]IFileSuffixesadapters are now multiapdaters (using request also)
so customizing types with browserlayer will be possible [keul]1.1.0 (2012-12-05)Fixed plugin (removedregion-contentid) [keul]Added label for additional info in file popup [keul]i18n support (and italian translation provided) [keul]Now uninstall cleanly [keul]Added link format inside advanced settings [keul]Now supporting new advanced and pluggable option: “Link format”
to handle how the URL to file is created [keul]Added support for internal link to image content type [keul]1.0.0 (2012-10-10)Fixed Plone 4 compatibility icons drawing in popup template [cekk]0.2.1 (2012-04-20)Version 0.2.0 was not upgrading properly [keul]0.2.0 (2012-04-20)now requirez3c.jbotbecause to fix a bug related to a broken context menu
[keul]no more using a separate link plugin, but we are forced to use the original
ones (for the fix above) [keul]added a product layer [keul]updated template and code to Product.TinyMCE 1.2 family [keul]0.1.0 (2011-10-13)University of Ferraraprovided some more CSS rules for better integration
with MS Office files [keul]0.0.1alpha (2010-07-20)initial release