Code Monkey home page Code Monkey logo

nopwatermark's Introduction

nopWatermark - image watermark plugin for NopCommerce

GitHub Issues Contributions welcome License: GPL v3

This repository contains Image Watermark Plugin for NopCommerce version 3.5, 3.6, 3.7, 3.8, 3.9, 4.0, 4.10, 4.20, 4.30, 4.40, 4.50, 4.60. This plugin dynamically adds watermarks (text or picture) to the store pictures without changing the original images. This plugin also supports a multi-store configuration.

Please note: this plugin doesn't apply watermarks to SVG images.

Table of contents

Download

You can download plugin from marketplace or github

Upgrade to the new version

To upgrade a plugin:

  • Uninstall the plugin from your store (Plugin nopCommerce documentation).
  • Upload the new version of the plugin to the /plugins folder in your nopCommerce directory.
  • Restart your application (or click "Relod list of plugins" button).
  • Scroll down through the list of plugins to find the newly installed plugin.
  • Click on the Install link to install the plugin.
  • The plugin is displayed in the Plugins windows (Configuration → Plugins → Local Plugins).

In nopCommerce >=4.00 you can also:

  • Go to the Plugins windows (Configuration → Plugins → Local Plugins).
  • Uninstall the plugin.
  • Delete the plugin (click "Delete" button).
  • Click "Upload plugin" button.
  • Select zip file that contains the new verion of the plugin and upload it.
  • Click on the Install link to install the plugin.
  • The plugin is displayed in the Plugins windows.

Installation

To install a plugin:

  • Upload the plugin to the /plugins folder in your nopCommerce directory.
  • Restart your application (or click "Relod list of plugins" button).
  • Scroll down through the list of plugins to find the newly installed plugin.
  • Click on the Install link to install the plugin.
  • The plugin is displayed in the Plugins windows (Configuration → Plugins → Local Plugins).

In nopCommerce >=4.00 you can also:

  • Go to the Plugins windows (Configuration → Plugins → Local Plugins).
  • Click "Upload plugin" button.
  • Select zip file that contains the plugin and upload it.
  • Click on the Install link to install the plugin.
  • The plugin is displayed in the Plugins windows.

Configuration

  • Go to the “Administration -> Plugins -> Local Plugins”
  • Find “Image Watermark” in the plugin list.
  • Click “Configure”.

Plugin configuration

Text watermark

This section contains a configuration for a text watermark.

Text watermark

Options:

  • Enable text watermark – check this box to enable text watermark.
  • Text – this text will be displayed in the store pictures.
  • You can also select: text font, text color, watermark size in % relative to the original image, position of the watermark text, opacity (0 – transparent text, 1 – opaque text) and watermark text rotation angle.

There is the possibility of using custom fonts for text watermark. This can be achieved by placing the TTF font file in the Fonts folder. After installing/reloading the plugin, the added font will appear in the Text font plugin setting.

Picture watermark

This section contains a configuration a picture watermark.

Picture watermark

Options:

  • Enable picture watermark – check this box to enable picture watermark.
  • Picture – upload a watermark picture file.
  • You can also select: watermark size in % relative to the original image, position of the watermark text, opacity (0 – transparent text, 1 – opaque text).

Common settings

This section contains common configuration for a text/picture watermark.

Common settings

Options:

  • Tick the check boxes to select the sections to place the watermark: Products, Categories, Manufacturers.
  • Enter the minimum image width/height to place the watermark. Watermarks will only be displayed on images that are larger/higher than the specified width/height. If width/height = 0, the watermark will be applied for all image sizes.

Finally click "Save".

Multi-store configuration

Select the store in multi-store configuration list. Tick/untick check boxes to change configure the watermark values for the selected store.

Multi-store configuration

Localization

The plugin is available in 3 languages: English, Russian, Ukrainian.

You can add custom localization files to the "Resources" folder. The file name should look like this: "Locale.seoCode.xml", where seoCode is two letter unique language code (List of codes).

To add a custom localization file:

  • Open an existing localization file in a text editor.
  • Change the "Value" property to the custom language value.
  • Save file with file name "Locale.seoCode.xml", where seoCode is two letter unique code for the added language (List of codes) in the "Resource" folder.
  • Reinstall the plugin (Plugin nopCommerce documentation).

Examples

Text watermark

Text watermark

Product details page

Picture watermark

Picture watermark

Products list

Uninstallation

Want to uninstall and revert back? Please feel free to open an issue regarding how we can improve this plugin.

To uninstall plugin:

  • Go to Configuration → Plugins → Local Plugins.
  • Click the Uninstall link beside the Image Watermark plugin to uninstall. The plugin is uninstalled. The link text in the Installation column changes to "Install" enabling you to reinstall the plugin at any time.

Build process

  • Clone this repository into nopCommerce/src/Plugins folder (git clone https://github.com/MarinaAndreeva/nopWatermark.git)
  • Add Nop.Plugin.Misc.Watermark.csproj to nopCommerce solution as existing project into "Plugins" folder.
  • Build the project, plugin's files will be placed in the nopCommerce/src/Presentation/Nop.Web/Plugins/Misc.Watermark folder.

Authors

License

The Watermark Plugin for nopCommerce is licensed under the terms of the GPL v3 Open Source license and is available for free for commercial and personal usage.

nopwatermark's People

Contributors

marinaandreeva avatar zandiarash avatar ni-fara avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.