Magento 2 Israel Post Domestic Documentation

1. Introduction

About the Plugin

Transform Your Shipping Workflow: Our app is a game-changer for e-commerce, particularly high-volume businesses. Automate order processing, minimize errors, and save valuable time. Seamlessly integrate with Israel Post, simplifying shipping. From small online shops to large retailers, our app streamlines shipping management. It's not merely a convenience; it's an essential tool in today's competitive e-commerce arena. Join satisfied merchants benefiting from efficient shipping logistics.

Plugin Features

• Feature 1: Seamless Integration
• Feature 2: Error-Free Automation
• Feature 3: Efficient Label Printing

System Requirements

• WordPress 6.0
• PHP 7.4
• **IonCube Loader**: This plugin requires IonCube Loader to be installed on your server for proper functionality. IonCube Loader is a PHP extension used for decoding encrypted PHP files. You can download IonCube Loader from IonCube's official website.

2. Installation

Installation via WordPress Dashboard

1. Log in to your WordPress admin dashboard.
2. Go to the "Plugins" menu.
3. Click "Add New."
4. Click "Upload Plugin" on the top of this page.
5. Choose the zip file of the plugin.
6. Click "Install Now" for the "Israel Post Domestic" plugin.
7. After installation, click "Activate" to enable the plugin.

Manual Installation

1. Download the "Israel Post Domestic" plugin from [link to plugin page].
2. Upload the plugin folder to the `/wp-content/plugins/` directory on your server.
3. Activate the plugin through the WordPress admin dashboard.

3. Getting Started

Plugin Activation

To start using the plugin, follow these steps:

1. Log in to your WordPress admin dashboard.
2. Go to the "Plugins" menu.
3. Locate "Israel Post Domestic" in the list of plugins.
4. Click the "Activate" link below the plugin name.

Plugin Configuration

To configure the plugin, follow these steps:

1. Log in to your WordPress admin dashboard.
2. Go to the "Plugins" menu.
3. Locate "Israel Post Domestic" in the list of plugins.
4. Click the "Settings" link below the plugin name.

In the main setting page, you will find four tabs:

License

• Below, you'll see a form. Please complete all the required information and click "Register."
• After registration, you'll receive a license for your plugin. If it shows "Valid," you're good to go. If it's "Invalid," please contact support.

Account Settings

In this section, fill in all the relevant fields based on the information provided by the shipping company:

• Click "Save" to save the information.

Locations

To add a location:

• Click "Add."
• Complete the location fields. This information helps the shipping company locate your warehouse or store for package pickup.
• Click "Save" to save the information.

Global settings

In this section, you can configure various aspects of the plugin and its behavior:

• Select Maps View Option: Choose how it behaves when using podu only.
• Maps API: If you use maps, you MUST have a Google API key. We've provided a link explaining how to obtain the key.
• Show Notes in Shipping Comments: If checked, it will include the order customer notes in the shipping label.
• Products in Comments: If checked, it will include the list of order items in the shipping label.
• Replace City Input in Autocomplete: If checked, the city field in the checkout becomes auto-complete based on a predefined cities list.
• Replace Pickup Input in Autocomplete: If checked, the podu city field in the checkout becomes auto-complete from a predefined cities list.
• Skip jQuery: Check this if you encounter checkout issues due to jQuery conflicts.
• Select a Status for Automatically Send Shipping: If a status is selected, the plugin will automatically send the order to the shipping company when the order's status changes to the selected status.
• Allow Sending Automatic Orders with a Greater Order Number: This option allows you to limit automatic order sending by order number to prevent older orders from being sent accidentally.
• Filter by Shipping Method: Use this multiselect to limit the plugin's functionality based on specific shipping methods. For example, you can exclude the "pickup from store" shipping method.
• Enable Shipment Tracking Inside My Account: This option adds a section to the "My Account" page, allowing customers to track their orders and view statuses.
• Enable Email on Shipment Tracking Update: If checked, emails are sent with shipping information when tracking numbers are created.
• Custom Tracking Link: Here, you can add custom links for tracking, such as a link to the dedicated shipping company's tracking page.
• Checkout Fields Mapping: This section is mainly for developers to adjust fields and information sent to the shipping company if custom fields are created.

4. Useage

Using Israel Post Domestic Widgets - Tracking Label Creation

Our plugin simplifies the process of generating tracking labels with a single click. You have two convenient options to create tracking numbers for your orders: from the Orders Page and the Order Edit Page.

Orders Page

1. New Column: In the Orders Page, our plugin adds a new column for your convenience. Inside this column, you'll find two buttons: "Edit" and "Send."
2. Edit Button: The "Edit" button allows you to preview and modify the information before sending it. You can review the details and make any necessary adjustments.
3. Send Button: The "Send" button provides a quick and straightforward way to send tracking information. Upon successful submission, you'll receive a tracking number.
4. Quick Print: After sending, a "Print" button appears, enabling you to swiftly print the tracking label.
5. Bulk Send: If you need to send tracking numbers for multiple orders, you can select them using checkboxes next to each order. Clicking the "Bulk Shipments" button at the top initiates the process. A popup displays an overview of the orders you're about to send. Click "Send" within the popup to transmit each order. A complete icon indicates which orders were successfully sent.

Order Edit Page

1. Side Widget: On the Order Edit Page, you'll find our plugin's form in a convenient side widget.
2. Modify Order Information: Within the widget, you can review and modify the order information as needed.
3. Send: Click the "Send" button to transmit the order. Once successfully sent, you'll receive the tracking number, and a "Print" button will be available for quick printing.

Our plugin streamlines the tracking label creation process, whether you're handling individual orders or sending them in bulk.

Shortcodes - Frontend Shipment Tracking

We provide a convenient shortcode that allows users to track their shipments directly on the frontend of your website. Users can input their order number and shipping number to receive the current status of their shipment. This shortcode can be placed anywhere on your website for easy access.

Shortcode:

[datalogics_shipping_tracker]

5. Customization Options

While most parts of our plugin are not open source and cannot be modified, we provide flexibility in certain areas for customization:

CSS Customization:

You have the freedom to override the CSS styles for the Podu maps displayed on the checkout and tracking forms. Customize the appearance to match your website's design and layout.

Email Template Customization:

Our plugin offers an email template for tracking numbers. This file is not encrypted and can be easily accessed in the "templates" folder within the plugin directory. Modify this template to tailor the email notifications sent to your customers.

Translations:

You can customize translations used within the plugin. Utilize tools like the Loco Translate plugin or directly edit the translation files to adapt the language and wording to your specific needs.

6. Troubleshooting

Common Issues

-

(FAQs) Frequently Asked Questions

1. Are updates and bug fixes provided for the plugin?
   Answer: Yes, we regularly release updates and bug fixes to ensure that the plugin functions smoothly and stays up-to-date with WordPress changes.
2. Can I request additional features or customization for the plugin?
   Answer: We welcome feature requests and customization inquiries. Please contact our support team to discuss your specific requirements.

7. Support

Getting Help

If you need assistance or have questions about the plugin, our support team is here to help. Here's how you can get in touch:

1. Documentation: Check our comprehensive documentation for step-by-step guides and answers to common questions. You may find the information you need without needing to contact support.
2. Support Tickets: If you can't find the solution in our documentation, you can open a support ticket. Simply visit our support portal and submit your request. Our team will respond to your inquiry as quickly as possible.

Reporting Issues

If you encounter any bugs or issues with the plugin, we appreciate your feedback. Reporting issues helps us improve the plugin for everyone. Here's how you can report problems:

1. Bugs: If you believe you've found a bug in the plugin, please submit a detailed bug report. Include information about the issue, steps to reproduce it, and any error messages you've
2. Feature Requests:If you have ideas for new features or improvements, let us know! We welcome feature requests and consider them for future updates.

8. Changelog

Version 1.0.0

• Added: -
• Updated: -
• Fixed: -
• Removed: -

9. License

Israel Post Domestic plugin for magento is proprietary software owned by Dreamax LTD. It is closed-source and protected by copyright law.

Usage License

Dreamax LTD grants you a limited, non-exclusive, non-transferable, revocable license to use Israel Post Domestic plugin for magento in accordance with the terms and conditions outlined in this documentation.

Restrictions

• You are not permitted to distribute, sublicense, sell, or make any part of Israel Post Domestic available to third parties without prior written consent from Dreamax LTD.
• Unauthorized reproduction, distribution, or modification of Israel Post Domestic is strictly prohibited and may result in legal action.
• This license does not grant you any right to any updates, improvements, or support services related to Israel Post Domestic.

Warranty and Support

Israel Post Domestic is provided "as is" without any warranties or guarantees. Dreamax LTD does not provide any warranty, express or implied, regarding the performance, functionality, or fitness for a particular purpose of this software.

Contact Information

For inquiries or licensing requests, please contact Dreamax LTD at tal@datalogics.co.il.