fritzmg / contao-sharebuttons

为Contao提供分享按钮的简单扩展,作为模块和内容元素

资助包维护!
fritzmg

安装次数: 27,233

依赖: 0

建议者: 0

安全性: 0

星标: 18

关注者: 2

分支: 2

开放问题: 7

类型:contao-module

2.2.4 2023-05-04 17:38 UTC

README

Contao Share Buttons

Contao的简单扩展,提供模块、内容元素以及新闻文章中的分享按钮。在每种情况下,您都有一组相同的选项。

Element settings

主题

在每种情况下,您还可以设置一个可选的主题。如果您选择了一个主题,将为按钮包含基本的样式,使它们水平对齐并应用背景图像。以下是目前可用的主题

Available themes

从上到下

  • Boxxed
  • Boxxed(16像素)
  • Contao
  • Light
  • Shadow
  • Simple Flat
  • Simple Icons Black
  • Simple Icons White(灰色背景添加以提高可见性)
  • Font Awesome

"Contao"主题使用Contao自己的图标,但只有Facebook和Twitter可用。还有一个名为"Text"的主题,它只是将元素水平对齐,但按钮的文本内容仍然可见。

以下主题为高DPI设备提供更高分辨率的图像

  • Boxxed(16像素)
  • Light
  • Shadow
  • Simple Flat
  • Simple Icons Black
  • Simple Icons White

模板

您还可以在每个元素中设置模板,如果您在某些情况下需要不同的结构。如果您想使用自己的模板,请创建一个以sharebuttons_开头的名称,并将其放在您的模板文件夹中。

Font Awesome

从版本1.1.0开始,也有Font Awesome图标的主题和模板。如果您已将Font Awesome图标字体集成到您的页面中,并想将其用于分享按钮,请简单地选择sharebuttons_fontawesome模板。在主题方面,您可以选择文本Font Awesome。后者的样式会使图标的大小与其他主题相似。如果您选择这三个之外的任何主题,并且已经选择了模板,则默认为当前Font Awesome主题。

如果您想替换按钮的图标,只需创建自己的sharebuttons_fontawesome模板(或将其重命名为其他名称)并替换fa-类。例如,如果您想使用Facebook的方块版本,只需将fa-facebook替换为fa-facebook-square

新闻、事件、文章

您可以直接在news_*event_*mod_article*模板中输出分享按钮

<?= $this->sharebuttons ?>

您可以在新闻存档、日历或文章设置中设置新闻分享按钮的选项。

以这种方式使用分享按钮特别重要,如果您想在新闻或事件列表中显示分享按钮或显示文章摘要,否则URL和标题将不正确(因为分享按钮只是使用当前页面的URL和标题)。

插入标签

从版本1.1.0开始,还有一个插入标签可用。插入标签的名称是sharebuttons,可以按照以下方式传递参数,如主题、模板和网络

{{sharebuttons::THEME::TEMPLATE::NETWORK:NETWORK:...}}

所有参数都是可选的(然而,如果没有网络,则不会显示任何内容)。以下插入标签将创建具有boxxed主题的所有可用社交网络的分享按钮

{{sharebuttons::boxxed::facebook:twitter:linkedin:xing:mail:tumblr:pinterest:reddit:whatsapp:print:pdf}}

以下插入标签将简单地生成Facebook和Twitter分享按钮的HTML源代码,而不包括主题的样式表

{{sharebuttons::facebook:twitter}}

请查看位于 config/config.php$GLOBALS['sharebuttons']['themes']$GLOBALS['sharebuttons']['networks'] 数组,以找到您所需网络和主题的关键字符串。

从版本 2.1.0 开始,如果您想为特定文章提供PDF链接,也可以定义文章ID。

{{sharebuttons::pdf::6}}

Pinterest按钮

Pinterest分享按钮仅在有图像时显示。图像可以以三种方式存在:

  • 如果您通过 <?= $this->sharebuttons ?> 在新闻或事件模板中使用sharebuttons,Pinterest按钮将自动使用摘要图像。
  • 只需安装social_images扩展(也在ER2中可用),并在布局中启用它。Pinterest分享按钮将自动获取第一个可用的社交图像。
  • 您还可以通过在任何模板或PHP脚本中在生成sharebuttons之前,在$GLOBALS['SOCIAL_IMAGES'][0]中提供图像的绝对URL来手动设置社交图像。

归属

图标来源