topic Re: Alfresco Share 4.0 - making changes to out of the box files in Alfresco Archive

Alfresco Share 4.0 - making changes to out of the box files

bengrah — Wed, 07 Mar 2012 11:46:18 GMT

Hi all.I'm just playing about with some of the out of the box files for document actions. I've made a copy of actions.js, made some changes, minified it using the YUI Compressor and copied it back into the /webapps/share/components/documentlibrary directory and overwritten the original file. But I c

Re: Alfresco Share 4.0 - making changes to out of the box files

jpotts — Wed, 07 Mar 2012 22:59:53 GMT

Sounds like you are just playing around, but I feel duty-bound to tell you anyway: You probably shouldn't change the client-side JavaScript files. You should be able to extend those JavaScript components to add your own functionality. And when you do that, it is a really good idea to use your own namespace. If you need an example of how to do that, check out rule-config-action-custom.js script in the custom actions tutorial.

Still, what you are doing should be possible.

Make sure you have a non-minified version of the script called actions.js and a minified version of the script called actions-min.js. Share determines which one to use based on the client-debug flag in share-config-custom.xml:

    <config replace="true">
        <flags>
            <client-debug>false</client-debug>
            <client-debug-autologging>false</client-debug-autologging>
        </flags>
    </config>‍‍‍‍‍‍

If you have that flag set to false, it uses the minified version and if it is set to true it uses the non-minified version.

Maybe you didn't replace both the minified and the non-minified versions of the file and Share is using the one you didn't expect?

If that's not it and you are sure you've cleared your cache, you can always use Firebug or the equivalent JavaScript console in your browser to set some breakpoints and figure out what's going on.

Jeff

Re: Alfresco Share 4.0 - making changes to out of the box files

bengrah — Thu, 08 Mar 2012 16:03:41 GMT

Sounds like you are just playing around, but I feel duty-bound to tell you anyway: You probably shouldn't change the client-side JavaScript files. You should be able to extend those JavaScript components to add your own functionality. And when you do that, it is a really good idea to use your own namespace. If you need an example of how to do that, check out rule-config-action-custom.js script in the custom actions tutorial.

Still, what you are doing should be possible.

Make sure you have a non-minified version of the script called actions.js and a minified version of the script called actions-min.js. Share determines which one to use based on the client-debug flag in share-config-custom.xml:
    <config replace="true">
        <flags>
            <client-debug>false</client-debug>
            <client-debug-autologging>false</client-debug-autologging>
        </flags>
    </config>‍‍‍‍‍‍
If you have that flag set to false, it uses the minified version and if it is set to true it uses the non-minified version.

Maybe you didn't replace both the minified and the non-minified versions of the file and Share is using the one you didn't expect?

If that's not it and you are sure you've cleared your cache, you can always use Firebug or the equivalent JavaScript console in your browser to set some breakpoints and figure out what's going on.

Jeff

Hi Jeff, thanks for the update. It turns out I was looking at the wrong actions javascript file. I should've been looking at documentlibrary-actions.js instead.

Are you able to overwrite the out of the box JS using a JAR file with the same path? I will also check out your example, especially relating to the Custom Action, it's something I'd like to look into regarding notifications.