code cleanup

Author: zsoltoroszlany82

README.md

@@ -1,6 +1,6 @@
 # Playful Sparkle - Google Analytics for OpenCart 3
 
-The ***Playful Sparkle - Google Analytics (GA4) Extension*** for OpenCart 3 is a powerful tool designed to integrate Google Analytics (GA4) seamlessly into OpenCart websites, even for users without coding skills. This extension simplifies the process of tracking website performance and customer interactions, providing insights into user behaviors, traffic sources, and shopping trends directly within GA4. With features like easy installation, event tracking, and real-time data synchronization, this extension empowers users to make data-driven decisions, improve their online store’s performance, and enhance customer experience—all without needing technical expertise.
+The ***Playful Sparkle - Google Analytics (GA4) Extension*** for OpenCart 3.x is a powerful tool designed to integrate Google Analytics (GA4) seamlessly into OpenCart websites, even for users without coding skills. This extension simplifies the process of tracking website performance and customer interactions, providing insights into user behaviors, traffic sources, and shopping trends directly within GA4. With features like easy installation, event tracking, and real-time data synchronization, this extension empowers users to make data-driven decisions, improve their online store’s performance, and enhance customer experience—all without needing technical expertise.
 
 ### What is Google Analytics (GA4)?
 Google Analytics (GA4) is the newest version of Google’s powerful tool for tracking and understanding website and app activity. Unlike previous versions, GA4 uses machine learning to provide insights into customer behavior across different devices and platforms. It’s designed to help businesses see what’s working, make data-driven decisions, and improve the user experience easily.
@@ -36,3 +36,15 @@ Download the latest **Playful Sparkle - Google Analytics (GA4)** release from th
 ## Support & Feedback
 
 For support or any inquiries regarding the extension, feel free to open an issue on this repository or reach out via email at [support@playfulsparkle.com](mailto:support@playfulsparkle.com).
+
+---
+
+## License
+
+This project is licensed under the GPL-3.0 license. See the [LICENSE](./LICENSE) file for more information.
+
+---
+
+## Contributing
+
+We welcome contributions! If you would like to contribute to this project, please fork the repository and submit a pull request with your changes.

src/installation.txt

@@ -0,0 +1,42 @@
+Playful Sparkle - Google Analytics (GA4)
+
+The Playful Sparkle - Google Analytics (GA4) is a powerful tool designed to integrate Google Analytics GA4 seamlessly into OpenCart websites, even for users without coding skills. This extension simplifies the process of tracking website performance and customer interactions, providing insights into user behaviors, traffic sources, and shopping trends directly within GA4. With features like easy installation, event tracking, and real-time data synchronization, this extension empowers users to make data-driven decisions, improve their online store’s performance, and enhance customer experience—all without needing technical expertise.
+
+### What is Google Analytics (GA4)?
+
+Google Analytics (GA4) is the newest version of Google’s powerful tool for tracking and understanding website and app activity. Unlike previous versions, GA4 uses machine learning to provide insights into customer behavior across different devices and platforms. It’s designed to help businesses see what’s working, make data-driven decisions, and improve the user experience easily.
+
+Google Analytics (GA4) is used to track and analyze how people interact with websites and apps, giving businesses insights into their customers’ actions and preferences. It allows you to see details like where visitors come from, what pages they view, and how long they stay. GA4 can also track specific events, such as when users click a button, complete a form, or make a purchase.
+
+The benefits of GA4 include a more complete view of the customer journey, as it combines data from both websites and apps into one place. Its advanced machine learning models can automatically detect trends, predict future behaviors, and uncover hidden insights, helping businesses optimize marketing strategies. Additionally, GA4’s event-based tracking is more flexible than past versions, allowing for better customization and a clearer understanding of user engagement.
+
+For more information, visit the extension GitHub page at https://github.com/playfulsparkle/oc4_google_analytics.git.
+
+Demo frontend - https://opencart3.playfulsparkle.com/
+Demo backend - https://opencart3.playfulsparkle.com/admin/
+
+Installation Guide
+
+1. Download the "Playful Sparkle - Google Analytics (GA4)" Extension Package:
+   - Download the latest version of the Playful Sparkle - Google Analytics (GA4) extension from the repository or the link provided on this page.
+
+2. Upload the Extension Files:
+   - Log in to your OpenCart admin panel.
+   - Go to Extensions > Installer.
+   - Click the "Upload" button and upload the `ps_google_analytics.ocmod.zip` file.
+
+3. Install the Extension:
+   - After uploading, find the Playful Sparkle - Google Analytics (GA4) extension and click the green "Install" button.
+   - Navigate to Extensions and select Analytics (GA4) from the dropdown.
+   - Locate the "Playful Sparkle - Google Analytics (GA4)" in the module list and click the green "Install" button.
+
+4. Configure the Extension:
+   - Go to the Extensions page and ensure Analytics (GA4) is selected.
+   - Click the "Edit" button next to the installed Playful Sparkle - Google Analytics (GA4) extension.
+   - Enter your Google tag ID (G-XXXXXXXXXX) in the provided field.
+   - Set the status to "Enabled" to activate the module.
+   - Save your configuration.
+
+Support & Feedback
+
+For support or any inquiries regarding the extension, feel free to open an issue on this repository or reach out via email at %s.

src/upload/admin/language/cs-cz/extension/analytics/ps_google_analytics.php

@@ -11,7 +11,7 @@
 $_['text_extension']                = 'Rozšíření';
 $_['text_edit']                     = 'Upravit Google Analytics (GA4)';
 $_['text_success']                  = 'Úspěch: Upravili jste Google Analytics (GA4)!';
-$_['text_getting_started']          = '<p><strong>Přehled:</strong> Rozšíření Playful Sparkle - Google Analytics (GA4) pro OpenCart 3 umožňuje jednoduše integrovat sledování Google Analytics (GA4) do vašeho obchodu OpenCart bez znalosti programování.</p><p><strong>Požadavky:</strong> Ujistěte se, že máte účet Google Analytics, platný Google Tag ID a používáte kompatibilní verzi OpenCart.</p>';
+$_['text_getting_started']          = '<p><strong>Přehled:</strong> Rozšíření Playful Sparkle - Google Analytics (GA4) pro OpenCart 3.x umožňuje jednoduše integrovat sledování Google Analytics (GA4) do vašeho obchodu OpenCart bez znalosti programování.</p><p><strong>Požadavky:</strong> Ujistěte se, že máte účet Google Analytics, platný Google Tag ID a používáte kompatibilní verzi OpenCart.</p>';
 $_['text_setup']                    = '<p><strong>Propojení Google Analytics:</strong> Přihlaste se do svého <a href="https://analytics.google.com" target="_blank" rel="noopener noreferrer">účtu Google Analytics</a>, přejděte do sekce Admin, vyberte svou vlastnost a získejte svůj Google Tag ID.</p>';
 $_['text_troubleshot']              = '<ul><li><strong>Google Tag ID nefunguje:</strong> Zkontrolujte, zda jste správně zadali Google Tag ID v nastaveních rozšíření.</li><li><strong>Zpoždění údajů v GA4:</strong> Mějte na paměti, že údaje se mohou objevit v Google Analytics až za několik hodin.</li><li><strong>Problémy s kompatibilitou:</strong> Ujistěte se, že vaše verze OpenCart je aktuální a kompatibilní s rozšířením.</li></ul>';
 $_['text_faq']                      = '<details><summary>Co dělat, když nevidím svá data v Google Analytics?</summary>Zkontrolujte své Google Tag ID a počkejte několik hodin, než se data načtou do GA4.</details><details><summary>Ako mohu zkontrolovat, zda rozšíření funguje?</summary>Na ověření svého nastavení použijte rozšíření Google Tag Assistant pro Chrome.</details><details><summary>Je toto rozšíření kompatibilní s jinými rozšířeními?</summary>Toto rozšíření je obecně kompatibilní, ale je nejlepší otestovat ho s ostatními rozšířeními nainstalovanými na vaší stránce.</details>';

src/upload/admin/language/de-de/extension/analytics/ps_google_analytics.php

@@ -11,7 +11,7 @@
 $_['text_extension']                = 'Erweiterungen';
 $_['text_edit']                     = 'Google Analytics (GA4) bearbeiten';
 $_['text_success']                  = 'Erfolg: Sie haben Google Analytics (GA4) geändert!';
-$_['text_getting_started']          = '<p><strong>Überblick:</strong> Die Playful Sparkle - Google Analytics (GA4) Erweiterung für OpenCart 3 ermöglicht Ihnen die einfache Integration des Google Analytics (GA4) Trackings in Ihren OpenCart-Shop, ohne dass Programmierkenntnisse erforderlich sind.</p><p><strong>Voraussetzungen:</strong> Stellen Sie sicher, dass Sie ein Google Analytics-Konto, eine gültige Google Tag-ID haben und dass Sie eine kompatible Version von OpenCart verwenden.</p>';
+$_['text_getting_started']          = '<p><strong>Überblick:</strong> Die Playful Sparkle - Google Analytics (GA4) Erweiterung für OpenCart 3.x ermöglicht Ihnen die einfache Integration des Google Analytics (GA4) Trackings in Ihren OpenCart-Shop, ohne dass Programmierkenntnisse erforderlich sind.</p><p><strong>Voraussetzungen:</strong> Stellen Sie sicher, dass Sie ein Google Analytics-Konto, eine gültige Google Tag-ID haben und dass Sie eine kompatible Version von OpenCart verwenden.</p>';
 $_['text_setup']                    = '<p><strong>Verknüpfen von Google Analytics:</strong> Melden Sie sich bei Ihrem <a href="https://analytics.google.com" target="_blank" rel="noopener noreferrer">Google Analytics-Konto</a> an, navigieren Sie zum Admin-Bereich, wählen Sie Ihre Property aus und holen Sie Ihre Google Tag-ID ab.</p>';
 $_['text_troubleshot']              = '<ul><li><strong>Google Tag-ID funktioniert nicht:</strong> Überprüfen Sie, ob Sie die richtige Google Tag-ID in den Einstellungen der Erweiterung eingegeben haben.</li><li><strong>Datenverzögerung in GA4:</strong> Beachten Sie, dass Daten möglicherweise einige Stunden benötigen, um in Google Analytics angezeigt zu werden.</li><li><strong>Kompatibilitätsprobleme:</strong> Stellen Sie sicher, dass Ihre OpenCart-Version aktuell und mit der Erweiterung kompatibel ist.</li></ul>';
 $_['text_faq']                      = '<details><summary>Was ist, wenn ich meine Daten nicht in Google Analytics sehe?</summary>Überprüfen Sie Ihre Google Tag-ID und lassen Sie einige Stunden zu, damit die Daten in GA4 geladen werden.</details><details><summary>Wie kann ich überprüfen, ob die Erweiterung funktioniert?</summary>Verwenden Sie die Google Tag Assistant Chrome-Erweiterung, um Ihre Einrichtung zu überprüfen.</details><details><summary>Ist diese Erweiterung mit anderen Erweiterungen kompatibel?</summary>Diese Erweiterung ist im Allgemeinen kompatibel, es ist jedoch am besten, sie mit anderen auf Ihrer Website installierten Erweiterungen zu testen.</details>';

src/upload/admin/language/en-gb/extension/analytics/ps_google_analytics.php

@@ -11,7 +11,7 @@
 $_['text_extension']                = 'Extensions';
 $_['text_edit']                     = 'Edit Google Analytics (GA4)';
 $_['text_success']                  = 'Success: You have modified Google Analytics (GA4)!';
-$_['text_getting_started']          = '<p><strong>Overview:</strong> The Playful Sparkle - Google Analytics (GA4) Extension for OpenCart 3 allows you to easily integrate Google Analytics (GA4) tracking into your OpenCart store without any coding skills.</p><p><strong>Requirements:</strong> Ensure you have a Google Analytics account, a valid Google Tag ID, and that you’re using a compatible version of OpenCart.</p>';
+$_['text_getting_started']          = '<p><strong>Overview:</strong> The Playful Sparkle - Google Analytics (GA4) for OpenCart 3.x allows you to easily integrate Google Analytics (GA4) tracking into your OpenCart store without any coding skills.</p><p><strong>Requirements:</strong> Ensure you have a Google Analytics account, a valid Google Tag ID, and that you’re using a compatible version of OpenCart.</p>';
 $_['text_setup']                    = '<p><strong>Linking Google Analytics:</strong> Log in to your <a href="https://analytics.google.com" target="_blank" rel="noopener noreferrer">Google Analytics account</a>, navigate to the Admin section, select your property, and retrieve your Google Tag ID.</p>';
 $_['text_troubleshot']              = '<ul><li><strong>Google Tag ID Not Working:</strong> Double-check that you’ve entered the correct Google Tag ID in the extension settings.</li><li><strong>Data Delay in GA4:</strong> Note that data may take a few hours to appear in Google Analytics.</li><li><strong>Compatibility Issues:</strong> Ensure your OpenCart version is up-to-date and compatible with the extension.</li></ul>';
 $_['text_faq']                      = '<details><summary>What if I don’t see my data in Google Analytics?</summary>Check your Google Tag ID and allow a few hours for data to populate in GA4.</details><details><summary>How can I check if the extension is working?</summary>Use the Google Tag Assistant Chrome extension to verify your setup.</details><details><summary>Is this extension compatible with other extensions?</summary>This extension is generally compatible, but it’s best to test it with other extensions installed on your site.</details>';

src/upload/admin/language/en-us/extension/analytics/ps_google_analytics.php

@@ -11,7 +11,7 @@
 $_['text_extension']                = 'Extensions';
 $_['text_edit']                     = 'Edit Google Analytics (GA4)';
 $_['text_success']                  = 'Success: You have modified Google Analytics (GA4)!';
-$_['text_getting_started']          = '<p><strong>Overview:</strong> The Playful Sparkle - Google Analytics (GA4) Extension for OpenCart 3 allows you to easily integrate Google Analytics (GA4) tracking into your OpenCart store without any coding skills.</p><p><strong>Requirements:</strong> Ensure you have a Google Analytics account, a valid Google Tag ID, and that you’re using a compatible version of OpenCart.</p>';
+$_['text_getting_started']          = '<p><strong>Overview:</strong> The Playful Sparkle - Google Analytics (GA4) for OpenCart 3.x allows you to easily integrate Google Analytics (GA4) tracking into your OpenCart store without any coding skills.</p><p><strong>Requirements:</strong> Ensure you have a Google Analytics account, a valid Google Tag ID, and that you’re using a compatible version of OpenCart.</p>';
 $_['text_setup']                    = '<p><strong>Linking Google Analytics:</strong> Log in to your <a href="https://analytics.google.com" target="_blank" rel="noopener noreferrer">Google Analytics account</a>, navigate to the Admin section, select your property, and retrieve your Google Tag ID.</p>';
 $_['text_troubleshot']              = '<ul><li><strong>Google Tag ID Not Working:</strong> Double-check that you’ve entered the correct Google Tag ID in the extension settings.</li><li><strong>Data Delay in GA4:</strong> Note that data may take a few hours to appear in Google Analytics.</li><li><strong>Compatibility Issues:</strong> Ensure your OpenCart version is up-to-date and compatible with the extension.</li></ul>';
 $_['text_faq']                      = '<details><summary>What if I don’t see my data in Google Analytics?</summary>Check your Google Tag ID and allow a few hours for data to populate in GA4.</details><details><summary>How can I check if the extension is working?</summary>Use the Google Tag Assistant Chrome extension to verify your setup.</details><details><summary>Is this extension compatible with other extensions?</summary>This extension is generally compatible, but it’s best to test it with other extensions installed on your site.</details>';

src/upload/admin/language/sk-sk/extension/analytics/ps_google_analytics.php

@@ -11,7 +11,7 @@
 $_['text_extension']                = 'Rozšírenia';
 $_['text_edit']                     = 'Upraviť Google Analytics (GA4)';
 $_['text_success']                  = 'Úspech: Upravil(a) ste Google Analytics (GA4)!';
-$_['text_getting_started']          = '<p><strong>Prehľad:</strong> Rozšírenie Playful Sparkle - Google Analytics (GA4) pre OpenCart 3 umožňuje jednoducho integrovať sledovanie Google Analytics (GA4) do vášho obchodu OpenCart bez znalosti programovania.</p><p><strong>Požiadavky:</strong> Uistite sa, že máte účet Google Analytics, platný Google Tag ID a používate kompatibilnú verziu OpenCart.</p>';
+$_['text_getting_started']          = '<p><strong>Prehľad:</strong> Rozšírenie Playful Sparkle - Google Analytics (GA4) pre OpenCart 3.x umožňuje jednoducho integrovať sledovanie Google Analytics (GA4) do vášho obchodu OpenCart bez znalosti programovania.</p><p><strong>Požiadavky:</strong> Uistite sa, že máte účet Google Analytics, platný Google Tag ID a používate kompatibilnú verziu OpenCart.</p>';
 $_['text_setup']                    = '<p><strong>Prepojenie Google Analytics:</strong> Prihláste sa do svojho <a href="https://analytics.google.com" target="_blank" rel="noopener noreferrer">účtu Google Analytics</a>, prejdite do sekcie Admin, vyberte svoju vlastnosť a získajte svoj Google Tag ID.</p>';
 $_['text_troubleshot']              = '<ul><li><strong>Google Tag ID nefunguje:</strong> Skontrolujte, či ste správne zadali Google Tag ID v nastaveniach rozšírenia.</li><li><strong>Meškanie údajov v GA4:</strong> Berte na vedomie, že údaje môžu trvať niekoľko hodín, kým sa objavia v Google Analytics.</li><li><strong>Problémy s kompatibilitou:</strong> Uistite sa, že je vaša verzia OpenCart aktuálna a kompatibilná s rozšírením.</li></ul>';
 $_['text_faq']                      = '<details><summary>Čo ak nevidím svoje údaje v Google Analytics?</summary>Skontrolujte svoj Google Tag ID a počkajte niekoľko hodín, kým sa údaje načítajú do GA4.</details><details><summary>Ako môžem skontrolovať, či rozšírenie funguje?</summary>Na overenie svojho nastavenia použite rozšírenie Google Tag Assistant pre Chrome.</details><details><summary>Je toto rozšírenie kompatibilné s inými rozšíreniami?</summary>Toto rozšírenie je všeobecne kompatibilné, ale je najlepšie otestovať ho s inými rozšíreniami nainštalovanými na vašej stránke.</details>';