alfresco - 如何在 Alfresco 中自定义文档列表？

Question

在存储库中会有不同的文档列表。即会有数据字典、用户主页、访客主页等。当我将视图更改为“详细视图”时，它会显示收藏夹、喜欢、评论链接。如果我不想显示它们，我必须在哪里修改。你能告诉我必须在哪个文件中评论不显示这些链接的代码吗？先感谢您。

Answer 1

我想要这个问题的“模块化”答案，这个答案是为了展示我是如何处理这个问题的。

上下文： Alfresco 4.2.f，来自org.alfresco.maven.archetype:alfresco-amp-archetype:1.1.1原型的 Maven 项目，我尽可能将所有内容都放在嵌入式 JAR 中。

为共享创建一个模块扩展（有关更多详细信息，请参阅此博客）。这是我的扩展文件：

src/main/resources/alfresco/site-data/extensions/my-custom-extension.xml

<extension>
  <modules>
    <module>
      <id>Main module of my custom extension</id>
      <version>${project.version}</version>
      <auto-deploy>true</auto-deploy>
      <customizations>
        <customization>
          <!-- Order matters here! target before source, always! -->
          <targetPackageRoot>org.alfresco</targetPackageRoot>
          <sourcePackageRoot>my-custom.main</sourcePackageRoot>
        </customization>
      </customizations>
    </module>
  </modules>
</extension>

在documentlibrary模块包的组件中，创建此 FTL 以声明 javascript：

src/main/resources/alfresco/site-webscripts/my-custom/main/components/documentlibrary/documentlist-v2.get.html.ftl

<#-- Add a Javascript declaration -->
<@markup id="my-custom-js"  target="js" action="after">
  <@script type="text/javascript" group="documentlibrary"
      src="${url.context}/res/my-custom/main/components/documentlibrary/documentlist.js"/>
</@>

在资源 (META-INF) 中的documentlibrary组件下，创建 Javascript：

src/main/resources/META-INF/my-custom/main/components/documentlibrary/documentlist.js

YAHOO.lang.augmentObject(Alfresco.DocumentList.prototype, {

  // Possible values: i18nLabel, lockBanner, syncFailed, syncTransientError
  // date, size, name, version, description, tags, categories
  myCustomDisabledRenderers: ["description", "version", "tags"],

  // Possible values: favourites, likes, comments, quickShare
  myCustomDisabledSocials: ["favourites", "comments", "likes", "quickShare"],

  myCustomIsSocialDisabled: function(propertyName) {
    return Alfresco.util.arrayContains(
        this.myCustomDisabledSocials, propertyName);
  },

  myCustomIsRendererDisabled: function(propertyName) {
    if (Alfresco.util.arrayContains(
        this.myCustomDisabledRenderers, propertyName)) {
      return true;
    }
    // Disable the social renderer when all the social features are
    // disabled
    if (propertyName === "social" && this.myCustomDisabledSocials.length == 4) {
      return true;
    }
    return false;
  },

  /** Helper function to disable socials
   * propertyName must be one of "favourites", "comments", "likes", "quickShare"
   */
  myCustomDisableSocial: function(propertyName) {
    if (!Alfresco.util.arrayContains(
        this.myCustomDisabledSocials, propertyName)) {
      this.myCustomDisabledSocials.push(propertyName);
    }
  },

  // Custom registerRenderer for social features, originally defined in:
  // webapps/share/components/documentlibrary/documentlist.js:2134
  myCustomSocialRegisterRenderer: function(record) {
    var jsNode = record.jsNode;
    var html = "";
    // Current usage of the separator variable allow to change the order
    // of the different social features (the 'if' blocks below) without 
    // changing their content
    var separator = "";
    /* Favourite / Likes / Comments */
    if (!this.myCustomIsSocialDisabled("favourites")) {
      html += '<span class="item item-social' + separator + '">' + 
          Alfresco.DocumentList.generateFavourite(this, record) + 
          '</span>';
      separator = " item-separator";
    }
    if (!this.myCustomIsSocialDisabled("likes")) {
      html += '<span class="item item-social' + separator + '">' + 
          Alfresco.DocumentList.generateLikes(this, record) + 
          '</span>';
      separator = " item-separator";
    }
    if (!this.myCustomIsSocialDisabled("comments") && 
        jsNode.permissions.user.CreateChildren) {
      html += '<span class="item item-social' + separator + '">' + 
          Alfresco.DocumentList.generateComments(this, record) + 
          '</span>';
      separator = " item-separator";
    }
    if (!this.myCustomIsSocialDisabled("quickShare") && !record.node.isContainer && 
        Alfresco.constants.QUICKSHARE_URL) {
      html += '<span class="item' + separator + '">' + 
          Alfresco.DocumentList.generateQuickShare(this, record) + 
          '</span>';
      separator = " item-separator";
    }

    return html;
  },

  // Overwrite registerRenderer which was originally defined in:
  // webapps/share/components/documentlibrary/documentlist.js:1789
  registerRenderer: function DL_registerRenderer(propertyName, renderer) {
    if (Alfresco.util.isValueSet(propertyName) && 
        Alfresco.util.isValueSet(renderer) && 
        !this.myCustomIsRendererDisabled(propertyName)) {
      if (propertyName === "social") {
        this.renderers[propertyName] = this.myCustomSocialRegisterRenderer;
      } else {
        this.renderers[propertyName] = renderer;
      }
      return true;
    }
    return false;
  }


}, true);

myCustomDisabledRenderers然后你可以通过更新和/或禁用链接mySocialDisabledRenderers。

这种方式还允许您创建一个模块，只需 6 个简单的步骤即可独立禁用（例如）“对文档的评论”或“对文档的喜欢”功能！

示例，如何制作一个仅通过 6 个步骤禁用文档评论的模块

1. documentlist.js重要提示：首先从主模块中删除“评论禁用” 。

   myCustomDisabledSocials: ["favourites", "likes", "quickShare"],
   

2. 创建一个具有相同结构的新模块“my-custom.nocomment”。

   <extension>
     <modules>
       <module>
         <id>Main module of my custom extension</id>
         [...]
       </module>
       <module>
         <id>No comment module of my custom extension</id>
         <version>${project.version}</version>
         <customizations>
           <customization>
             <targetPackageRoot>org.alfresco</targetPackageRoot>
             <sourcePackageRoot>my-custom.nocomment</sourcePackageRoot>
           </customization>
         </customizations>
       </module>
     </modules>
   </extension>
   

3. 添加 FTL...

   src/main/resources/alfresco/site-webscripts/my-custom/nocomment/components/documentlibrary/documentlist-v2.get.html.ftl

   <#-- Add a Javascript declaration -->
   <@markup id="my-custom-js"  target="js" action="after">
     <@script type="text/javascript" group="documentlibrary"
         src="${url.context}/res/my-custom/nocomment/components/documentlibrary/documentlist.js"/>
   </@>
   

4. 然后是Javascript...

   src/main/resources/META-INF/my-custom/nocomment/components/documentlibrary/documentlist.js

   Alfresco.DocumentList.prototype.myCustomDisableSocial("comment");
   

5. 然后我很高兴，如果您觉得一切顺利，请鼓掌！

6. 笔记：

   • nocomment模块依赖于模块main。
   • 在模块（in ）之后nocomment加载模块很重要。mainhttp://localhost:8080/share/page/modules/deploy
   • 为了使nocomment模块完整，您还需要从文档详细信息页面禁用评论，见下文。

从文档详细信息页面禁用评论

即使这个在其他地方有记录，这几天我花了很多时间搜索，我觉得我需要尽可能全面。

src/main/resources/alfresco/site-data/extensions/my-custom-extension.xml

将此添加到您的my-custom.nocomment模块声明中，您将摆脱文档详细信息页面中的评论表单和列表。

[...]
<module>
  <id>No comment module of my custom extension</id>
  [...]
  <components>
    <component>
      <region-id>comments</region-id>
      <source-id>document-details</source-id>
      <scope>template</scope>
      <sub-components>
        <sub-component id="default">
          <evaluations>
            <evaluation id="guaranteedToHide">
              <render>false</render>
            </evaluation>
          </evaluations>
        </sub-component>
      </sub-components>
    </component>
  </components>
</module>
[...]

src/main/resources/alfresco/site-webscripts/my-custom/nocomment/components/node-details/node-header.get.js

这是为了禁用文档详细信息页面标题上的按钮。

// Disable comments
for (var i = 0; i < model.widgets.length; i++) {
  if (model.widgets[i].id == "NodeHeader") {
    model.widgets[i].options.showComments = false;
  }
}
// And since it does not work, disable comments this way too
model.showComments = "false";

注意：我没有测试这些片段，它们是在“匿名化”之后从我的项目中获取的（基本上是重命名模块）。如果您发现错误，请告诉我。

Answer 2

您正在寻找的内容很可能是由客户端 JavaScript 生成的。您应该使用 share-config-custom.xml 将 Share 设置为开发模式，如下所示：

<alfresco-config>
    <!-- Put Share Client in debug mode -->
    <config replace="true">
        <flags>
            <client-debug>true</client-debug>
            <client-debug-autologging>false</client-debug-autologging>
        </flags>
    </config>
</alfresco-config>

然后，使用 firebug 或浏览器的开发者控制台来单步执行客户端 JavaScript。您应该能够找到呈现文档库元素的点。

您可以使用自己的组件覆盖 Alfresco 的客户端 JavaScript 组件。请将它们放在您自己的命名空间中以避免与 Alfresco 的冲突。

Answer 3

我通过在 share/src/alfresco/share-document-config 中的文件 share-documentlibrary-config.xml 中注释 {social} 行来做到这一点

...
<metadata-templates>
   <!-- Default (fallback) -->
     <template id="default">
        <line index="10" id="date">{date}{size}</line>
        <line index="20" id="description" view="detailed">{description}</line>
        <line index="30" id="tags" view="detailed">{tags}</line>
        <line index="40" id="categories" view="detailed" evaluator="evaluator.doclib.metadata.hasCategories">{categories}</line> -->
   <!-- <line index="50" id="social" view="detailed">{social}</line> -->
     </template>
...

有用！

Answer 4

看起来所有内容都在： \opt\alfresco-4.0.d\tomcat\webapps\share\components\documentlibrary\documentlist.js 我认为诀窍在于 this.registerRenderer("social"...) 返回1981 行之前的 html （在喜欢之前的收藏之后）假设你想至少保留 faorite

Answer 5

我不确定我是否理解你的问题 - 你试图在露天资源管理器的特定视图中隐藏一些列？如果是这样，您需要编辑 /jsp/browse/browse.jsp 文件，但我认为这不是一个好主意。也许实现你自己的 NodePropertyResolver 应该是更好的方法，看看我关于这个主题的旧博文：http: //www.shmoula.cz/adding-columns-to-custom-browse-jsp/