Package: redturtle.smartlink
Table of contentsIntroductionHandle back-end/front-end URLsMigrate ATLink to Smart Link (and back)Warning 1Warning 2Safe re-install, clean uninstallRequirementsCreditsAuthorsBefore this: ComboLinkChangelog1.3.2 (2017-04-24)1.3.1 (2017-03-28)1.3.0 (2016-12-23)1.2.2 (2016-06-15)1.2.1 (2013-02-15)1.2.0 (2012-10-25)1.1.3 (2012-09-13)1.1.2 (2012-05-23)1.1.1 (2012-05-18)1.1.0 (2012-02-20)1.0.0 (2011-11-03)1.0.0rc2 (2010-11-06)1.0.0rc1 (2010-09-12)0.7.3 (2010-06-03)0.7.2 (2010-04-06)0.7.1 (2010-03-26)0.7.0 (2010-03-26)0.6.1 (2010-03-10)0.6.0 (Unreleased)0.5.1 (2010-02-02)0.5.0 (2010-01-25)0.4.0 (2009-09-12)0.3.1 (2009-08-30)0.3.0 (2009-08-02)0.2.0beta (2009-04-03)0.1.0dev (2009-03-27)IntroductionAn enhanced version of the base Plone link content type.After installing this you’ll see that the Plone link will have a newimageandcaptionfields
like the News Item content type.Also the new Link type can handle internal (to Plone contents) and external links. You can use the
internal link field to automatically attach the link value to an internal content of the portal
(in a similar way used for related contents).An event-based system will also keep URLs updated even when you move/rename target document.You can also customize the link icon for being able to use a different icon from the default Plone ones.
Due to changes between Plone 3 and Plone 4 themes, we need to keep the Plone 3 approach for displaying icons
(not using CSS sprite. To restore the Plone 4 default way, disable thesmart_link.cssresource
and remove the “Icon (Expression)” value fromportal_typestool).When using an internal link you can choose to use title and description from the referenced content
instead of the ones you used in the Link content itself.
In this way the Link is more like aproxyof the referenced item.This feature is globally disabled by default (in the control panel), then can be enabled on every Link content
activating the “Use referenced content’s data” option.Handle back-end/front-end URLsThe Smart Link structure is nothing more that a ATLink content, so the way used to store URL
in the object or in the site’s catalog is the same as Plone. There is no magic behind.For this reason, when you are using Smart Link for internal references, thestaticURL is
stored and used.This will lead to problems when you are using this product for site where you have different
back-end/front-end URLs; those problems are the same you have when you don’t use this product!For this reason you must use the “Configure Smart Link” control panel to handle URL transformation.You can also use an option that says to Smart Link to store relative URLs, but this will also
include the Plone site id in every link (and you must rewrite this from Apache if you don’t
like this).Migrate ATLink to Smart Link (and back)Smart Link contains two Generic Setup import steps that can help you to transform all you ATLink
to Smart Link, or to go back to ATLink if you don’t like Smart Link anymore (automatically done
when you uninstall the product).Warning 1Smart Link shape-change itself to be the Link content type, and hide the basic Plone Link type. Old ATLink
already created will continue working normally, but only new created link will behave the Smart Link
features.Warning 2Pay attentionwhen you update the whole portal_catalog using ZMI from URLs different from
back-end or front-end ones (for example: using a SSH tunnel).If you run the update from (for example) “localhost:8090/site” and this URL is not the public
or one of the back-end URLs, all your internal links will be changed to this hostname!
Another catalog update (from the right URL) will fix this.Safe re-install, clean uninstallYou canre-installSmart Link safely for upgrade task or for restore changes, without any problem.If youuninstallit, all data from Smart Link will be removed. This means that if you re-install
it after all your internal links will not be linked to target contents.RequirementsSmart Link has been tested on:Plone 4.1Plone 4.2Plone 4.3CreditsDeveloped with the support of:Camera di Commercio di FerraraRegione Emilia RomagnaAzienda USL FerraraRete Civica Mo-Net - Comune di ModenaAll of them supports thePloneGov initiative.AuthorsThis product was developed by RedTurtle Technology team.Thanks to:Mauro Amico(mamico) for providing support and fixing issues.Stefan Strasserfor testing the product on Plone 4, and reports problemsBefore this: ComboLinkPart of the code of Smart Link was taken from theComboLinkPlone (and Plonegov) product.
This project was giving the same internal link feature in old 2.1/2.5 Plone releases.Changelog1.3.2 (2017-04-24)Removed wrong import inkeepLinkevent.
[cekk]1.3.1 (2017-03-28)Fixed issue with new proxy feature.
Local activation flag was unproperly ignored
[keul]Fixed an error at creation object
[ekulos]FixkeepLinkevent. now we handle correctly DX and AT contents
[cekk]1.3.0 (2016-12-23)End of the official support to Plone 3: itmaystill work but has not been tested.
[keul]New feature: a way to use title and description of the referenced internal content
(Poor Manbda.contentproxy).
This close#6.
[keul]1.2.2 (2016-06-15)FixkeepLinkevent for Dexterity items (with referenceablebehavior enabled)
referenced by a smartlink. Now we can delete the DX content without errors.
[cekk]1.2.1 (2013-02-15)Removed longly deprecated actionicons.xml [keul]Modern inclusion of referencebrowserwidget [keul]Restored tests on Plone 3.3 that were broken in version 1.2 [keul]Removed old ununsed import step (close#1) [keul]Fixed product to be Plone 4.3 compatible [keul]Old (4.2 and below) link_icon.gif now included with the product [keul]1.2.0 (2012-10-25)Added support for plone.app.imaging [cekk]1.1.3 (2012-09-13)Smart Link uninstall was changing the Generic Setup baseline context.
When we found it, we restore the “profile-Products.CMFPlone:plone”
(part of issue#1)
[keul]when uninstalling, restore old ATLink automatically
[keul]fixed many bad formatted portal messages visualization
[keul]uninstall now remove the persisten utility (fix the other
part of issue#1)
[keul]1.1.2 (2012-05-23)fixed a bug on Plone 3 if plone.app.blob is not present [keul]1.1.1 (2012-05-18)fixed tests for Plone 4.2 compatibility [keul]migrating “fake external links” now support the migration of URLs that
explicitly use “resolveuid” (sometimes Plone users are really evil)
[keul]1.1.0 (2012-02-20)added a link to the view that migrate to blob from the control panel [keul]added a newSmart Link: access configurationpermission for site configuration
that “Site Administrator” role can handle [keul]added an utility to convert “fake external” link to internal [keul]aligned allLink.xmlfiles to be Plone 4 compliant [keul]In Plone 4 the related items were duplicated (if used).
Now Plone 3.3 requirescollective.relateditems[keul]Moved URL transformation features to anILinkNormalizerUtility[keul]fixed all tests to be compatible again with Plone 3.3.6 [keul]fixed bug when providing a non ASCII URL (close#8) [keul]provide a count of updated links when using the administration
utility (close#6) [keul]provided an import step to migrate ATLink to Smart Link (close#7) [keul]provided an import step to go back to ATLink from Smart Link [keul]1.0.0 (2011-11-03)Plone 4.1 compatibilitysize of a smart link is the size of its image [keul]finally removed the fss.zcml. It’s time to BLOB man! [keul]added the BLOB extension for image field [mircoangelini]added BLOB migration view:blob-smartlink-migration[mircoangelini]fixed icon handling, going back to the Plone 3 icons, disabling
Sunburst CSS-sprite with a newsmart_link.cssresource [keul]when linking an internal content, do not display a simple URL
but a link using item’s title [keul]1.0.0rc2 (2010-11-06)reStructured text fixes [keul]uninstall was not working under Plone 4.0 (this close#5) [keul]URL utility description updated with latests features added in 1.0 version [keul]fixed duplicated icon when using (or not using anymore) this product on Plone 4 (close#4).
To make those additional icon disappear from Plone UI you may need a catalog update. [keul]configuration icon was not displayed properly on Plone 4 [keul]added the “Front-end main URL” feature (close#3) [keul]1.0.0rc1 (2010-09-12)Plone 4 compatibility [keul]The explicit use ofiw.fsshas been removed. Thefss.zcmlis still there and you can still include
it if you like, but you must do this manually [keul]ISmartLinkalso extends theIImageContentinterface [keul]A better uninstall procedure, that remove Plone UI stuff and restore original linked object status [keul]Added thefaviconfield, that drive the icon’s link [keul]Added theanchorfield, for manage anchor in internal links [keul]Moved new and old secondary fields to theAdvancedfieldset [keul]The “unlink” event when deleting a referenced object has been removed: keeping an additional index only for
this feature was not a soo good idea. Now the internal link will display the latest memoized link [keul]Aligned thesmartlink_viewwith the latest Plonelink_view, so now will also display the message
when you are not redirected to the target URL (however this will be untranslated on Plone < 3.3) [keul]Added tests [keul]Updated and fixed labels and texts all around and i18n translation too [keul]Splitted UI error warn when you don’t provide neither internal and external link, from the fact that you
provide both of them [keul]When unlinking an internal content, it’s cleaned from marker interface [keul]Switched front-end and back-end order in the config panel [keul]Fixed a bug that force the front-end URLs in config panel to be unique [keul]0.7.3 (2010-06-03)fix #2 - error upgrading from 0.4.* to 0.7.* (missing utility) [mauro]0.7.2 (2010-04-06)The “smartLink” event was usingdirectlyProvidesinstead ofalsoProvides… this was
corrupting some target objects (like: it was impossible to internally link a file that
use blobs) [keul]Removed the Plone 3.3+ dependency because Smart Link is providing the same feature
given by Plone 3.3 also on older Plone versions [keul]0.7.1 (2010-03-26)Version 0.7 had a stupid, unused dependency [keul]0.7.0 (2010-03-26)Added z3c.autoinclude support [keul]From this version the minimum requirement is Plone3.3[keul]Aligned with changes done to ATLink from Plone 3.3 [keul]Added a fakelink_redirect_view[keul]0.6.1 (2010-03-10)Fixed egg format [keul]README updated [keul]0.6.0 (Unreleased)Changed name of tool [fdelia]Added icon for tool [fdelia]0.5.1 (2010-02-02)Fix for the corrupted version 0.5.0 [fdelia]0.5.0 (2010-01-25)Added configuration panel to transform back-end links in front-end links [fdelia]Added configuration panel to have internal links relative and not absolute [fdelia]0.4.0 (2009-09-12)Keep relations of internal link even if the target content is renamed/moved [keul]Added a marker interface for internally linked contents [keul]When target object is deleted, the internal relation became a normal absolute URL info [keul]0.3.1 (2009-08-30)Restored the originalremoteUrlStringField , due to continuous bad integration with 3rd party
products (like p4a and collective.flowplayer) [keul]0.3.0 (2009-08-02)Fixed syntax error on relation name (“internal_page” was “interal_page”) [keul]Disabled the backup of basic Plone ATLink [keul]Fixed some integration problem in content/link.py related to p4a (remoteUrl) [lucabel]Fixed major bug in post_validate (validation was useless) [fdelia]Internalization with i18ndude [fdelia]Created italian translation [micecchi]Clean uninstall (restoring the original ATLink in portal_types) [keul]0.2.0beta (2009-04-03)Added a lot of ATLink methods not migrated to the SmartLink class.Fixed a bug that lead all reordering actions in folders with SmartLink inside to failure (or to chaotic results).
After migrating to this version from the 0.1.0 you can also launch thefix_meta_dataexternal method
or your folder will remains broken.0.1.0dev (2009-03-27)Initial release