init

Author: landsman

.gitignore

@@ -0,0 +1 @@
+/vendor/

README.md

@@ -0,0 +1,36 @@
+# Version parameter for [OpenCart 2.x](https://github.com/opencart/opencart)
+
+Helper function which fixing visitors browser cache issue after your changes at CSS or javascript
+
+## Preview
+
+![Source code](./doc/source_code.png)
+
+You can also use this function for your custom files (CSS / JS, images, ...) like this:
+``
+<link href="<?php echo versionNumber($style['href']); ?>" type="text/css" rel="<?php echo $style['rel']; ?>
+``
+
+## Installation
+
+1. Requiring installed [vQmod](https://github.com/vqmod/vqmod) because vQmod doesn't support installing via composer itself.
+2. `composer require burdapraha/oc_version_number dev-master`
+3. `composer require sasedev/composer-plugin-filecopier` for files manipulating
+4. Add this code to your composer.json project file, extra section:
+
+```
+    "extra": {
+        "filescopier": [
+            {
+                "source": "vendor/burdapraha/oc_version_number/upload",
+                "destination": "upload",
+                "debug": "true"
+            }
+        ]
+    }  
+```
+    
+It will move vQmod xml file to correct folder.
+
+5. optionally you can add row to your `.gitignore` file with path to svg.xml (example: upload/vqmod/xml/oc_version_number.xml)
+6. celebrate!

composer.json

@@ -0,0 +1,13 @@
+{
+    "name": "burdapraha/oc_version_number",
+    "description": "Helper function which fixing visitors browser cache issue after your changes at CSS or javascript",
+    "type": "vqmod-plugin",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Michal Landsman",
+            "email": "landsman@insuit.cz"
+        }
+    ],
+    "require": {}
+}

doc/source_code.png

@@ -0,0 +1,35 @@
+<modification>
+    <id>Version number for styles - cache issue</id>
+    <version>1.0.0</version>
+    <vqmver>2.1.5</vqmver>
+    <author>Michal Landsman</author>
+
+    <!-- add new function to the system helper -->
+    <file name="system/helper/general.php">
+        <operation info="version number">
+            <search position="after"><![CDATA[<?php]]></search>
+            <add>
+                <![CDATA[
+                    if(!function_exists('versionNumber')){
+                       function versionNumber($path) {
+
+                            $absolutePath   = DIR_APPLICATION . $path;
+                            $clearPath      = str_replace("catalog/catalog/", "catalog/", $absolutePath);
+                            $version = file_exists($clearPath) ? filectime($clearPath) : 'ERROR_FILE_NOT_EXIST!';
+                            return "{$path}?v={$version}";
+                        }
+                    }
+                ]]>
+            </add>
+        </operation>
+    </file>
+
+    <!-- replace styles calling with path contains version number, you can use this function for your another files in your theme ... -->
+    <file path="catalog/view/theme/*/template/common/" name="header.tpl">
+        <operation>
+            <search position="replace"><![CDATA[<link href="<?php echo $style['href']; ?>" type="text/css" rel="<?php echo $style['rel']; ?>" media="<?php echo $style['media']; ?>" />]]></search>
+            <add><![CDATA[<link href="<?php echo versionNumber($style['href']); ?>" type="text/css" rel="<?php echo $style['rel']; ?>" media="<?php echo $style['media']; ?>" />]]></add>
+        </operation>
+    </file>
+
+</modification>