一个高级的Plone TinyMCE插件,用于处理文件链接
项目描述
简介
这是一个Plone的TinyMCE编辑器插件。
它将以不太显眼的方式替换标准的plonelink插件,提供一种不同的方式来处理文件和图片内容的链接。
详细文档
当链接不是内部链接或不是文件链接时,将不会发生任何变化,并保持标准的Plone行为。
当你在Plone站点中链接一个文件或一个图片时,你通常会得到以下XHTML代码...
<a class="internal-link" href="my-pdf">Download the document</a>
相反,你会得到这个...
<a class="internal-link internal-link-tofile" href="my-pdf" type="application/pdf" title="pdf, 146.2 kB">Download the document</a>
(如果你已启用“使用UID链接”,也是同样的情况)
此插件还会为你的Plone站点添加CSS,
根据文件的MIME类型添加图像图标,位于链接的左侧(如果在IE中,需要IE 7或更高版本)
在链接文本之后将添加一个由CSS生成的文本,与在标题中找到的内容相同,放在括号中(需要IE 8或更高版本)。IE的老版本用户仍可借助标题HTML属性获得一些额外的信息。
正常页面的样子
你将在TinyMCE中找到的内容
自定义内容链接的格式
Plone通常不会以特殊方式管理文件链接(它仅生成指向内容基本URL的链接)。
此插件将在高级设置中添加一个新控件
高级设置中的“链接格式”选项
调整这些选项可以更改生成的链接格式,为它添加后缀。
- 直接链接到内容(TinyMCE默认值)
不添加任何后缀。
- 链接到内容的预览(图片的默认值)
指向内容视图的链接
- 链接到下载内容(文件的默认值)
强制下载文件(或图片)
大多数情况下,“链接到下载内容”类似于“直接链接到内容”:调用url/to/a/file类似于调用url/to/a/file/at_download/file,但如果没有显式地添加at_download/file,有时目标文件可以被浏览器插件打开(尤其是对于图片,url/to/an/image将在浏览器中打开图片)。
“链接到内容的预览”可用于创建不会打开附件,而是将用户移动到Plone内容的链接。
扩展自定义内容
假设你正在使用一个新的Plone内容类型,例如视频。你希望TinyMCE以自定义方式链接到视频内容。
你需要的是提供一个新的适配器,用于IFileSuffixes接口
<adapter for="your.package.content.IYourVideoType zope.publisher.interfaces.browser.IHTTPRequest" provides="collective.tinymceplugins.advfilelinks.interfaces.IFileSuffixes" factory=".adapters.YourVideoTypeDownloadSuffix" />
提供Python适配器代码
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 = 2
你可以提供三个选项
- download_suffix
提供在“链接到下载内容”时用于你的内容的后缀。
将值设置为None,则不会添加或使用后缀
- view_suffix
提供在“链接到内容的预览”时用于你的内容的后缀。
将值设置为None,则不会添加或使用后缀
- default_suffix
提供一个整数值,用于设置默认组合框选项。使用1表示第一个组合选项,2表示第二个,依此类推。
你可以使用此功能来覆盖文件和图片内容的默认行为。
依赖关系
此产品已在以下环境中测试
Plone 3.3.5和TinyMCE 1.1.12
Plone 4.2.4和TinyMCE 1.2.15
Internet Explorer 9用户
Products.TinyMCE 1.2及以下版本在IE 9(及更高版本)上存在已知问题。这些问题已在Products.TinyMCE 1.3中修复,但如上所述,此插件在版本1.3上不会工作。
除了升级,你还可以应用以下已知解决方案之一。
致谢
在艾米利亚-罗马涅大区的支持下开发;艾米利亚-罗马涅大区支持PloneGov倡议。
变更日志
1.3.2 (2014-12-10)
从原始的TinyMCE文件插件中移植了一个已关闭的bug修复。见 @0082163c6d [keul]
1.3.1 (2014-06-20)
修复了CSV图标(类似于 pull request #2 在 collective.mtrsetup)并设置为非二进制 [keul]
支持odp文件 [keul]
更改了zip和rar的图标 [keul]
1.3.0 (2014-05-27)
现在依赖于collective.mtrsetup来支持许多附加的MIME类型 [keul]
新增CSV支持 [giacomos, keul]
未知文件的默认图标 [giacomos, keul]
1.2.1 (2013-09-18)
修复了引用非文件内容时的JavaScript错误 [keul]
在不引用文件类型时不要显示附加文件的详细信息 [keul]
1.2.0 (2013-02-27)
恢复了默认TinyMCE链接后缀作为默认值 [keul]
添加了一个新的适配器选项:default_suffix,以便能够通过类型控制链接类型的默认值 [keul]
IFileSuffixes适配器现在是多适配器(使用请求也),因此使用browserlayer自定义类型将变得可能 [keul]
1.1.0 (2012-12-05)
修复了插件(删除了region-content id) [keul]
在文件弹出窗口中添加了附加信息的标签 [keul]
支持i18n(并提供了意大利语翻译) [keul]
现在可以干净地卸载 [keul]
在高级设置中添加了链接格式 [keul]
现在支持新的高级和可插拔选项:“链接格式”,以处理文件URL的创建方式 [keul]
添加了对图像内容类型的内部链接支持 [keul]
1.0.0 (2012-10-10)
修复了弹出模板中Plone 4兼容性图标绘制 [cekk]
0.2.1 (2012-04-20)
版本0.2.0没有正确升级 [keul]
0.2.0 (2012-04-20)
现在需要z3c.jbot,因为要修复与损坏的上下文菜单相关的bug [keul]
不再使用单独的链接插件,但被迫使用原始插件(为了上述修复) [keul]
添加了一个产品层 [keul]
更新模板和代码以兼容Product.TinyMCE 1.2系列 [keul]
0.1.0 (2011-10-13)
费拉拉大学提供了一些CSS规则,以更好地与MS Office文件集成 [keul]
0.0.1alpha (2010-07-20)
初始发布
项目详情
哈希值 for collective.tinymceplugins.advfilelinks-1.3.2.zip
算法 | 哈希摘要 | |
---|---|---|
SHA256 | a364c32aff5f694451e68ce19036c278d0a94b44b60bfd2ddd46dccde65f2bce |
|
MD5 | 16a70677fc2149b0e07feb834b328cb8 |
|
BLAKE2b-256 | ab920c0392389ef10e2afbd5a4f9b21af99c65074654da540f5186c6e9d7f48c |