فاکتورک (Faktorak)

Faktorak adds printable WooCommerce invoices, shipping labels, thermal receipts, optional proforma invoices, optional checkout map location capture, a manual invoice workflow, and orders/users CSV & Excel export inside wp-admin.

Features

• Print-friendly invoice and shipping label; final paper size is selected in the browser/printer print dialog.
• Thermal receipt printing with single and bulk printing.
• Optional simple order item list with buyer, item title, quantity, unit amount, line amount and total.
• Per-order shipping-label note for handling instructions such as fragile packages.
• Two invoice templates (modern and classic).
• Optional proforma invoices (custom order status + admin action to convert to payable order).
• Optional checkout map to capture delivery location (saved in order meta).
• Manual invoice builder in wp-admin (create official invoice or proforma from selected products).
• Manual invoices list page (لیست فاکتورها) with search/filter/delete and quick customer/payment link copy.
• AJAX product and customer search with customer autofill in manual invoice form.
• Order list quick actions column (invoice + shipping label + thermal receipt + optional item list) in both legacy and HPOS order screens.
• Orders export to CSV/Excel plus bulk invoice PDF output.
• Users export to CSV/Excel with role and registration date filters.
• Shortcodes:
  • [faktorak_invoice_button]
  • [faktorak_proforma_button]
  • [faktorak_checkout_map]
• Local QR code rendering (no external QR service).
• Capability and token based protection for invoice/shipping label/item-list links.
• Payment button inside invoice view for unpaid manual invoices/proformas.
• Automatic conversion of paid proforma document type to official invoice.
• Optional seller signature image on invoice templates.
• Unified admin UI and Estedad typography (libre/OFL Persian font) across all plugin pages.

Usage

• Admin: Open an order and use the metabox to print the invoice, shipping label or thermal receipt.
• Admin: Enable the item list in Faktorak settings to show its print button beside the other order outputs.
• Admin: Enter an optional shipping-label note in the Faktorak order metabox; empty notes are not printed.
• Admin: Use Faktorak > فاکتور دستی to create manual invoices/proformas and manage them from لیست فاکتورها.
• Admin: Use the bulk actions on the orders list to print invoices, labels or thermal receipts in one batch.
• Customer: Use the shortcode button (or enable customer buttons in settings) to view/print invoices.
• Proforma: Enable the proforma option to allow creating a proforma invoice from the cart.
• Manual proforma payment: send the generated payment link to customer or use the payment button directly in invoice view.
• Checkout map: Enable the map option and choose either automatic placement inside the classic checkout form or manual placement with [faktorak_checkout_map]. In shortcode mode, the map may be placed in a separate Elementor Shortcode widget on the assigned checkout page; its confirmed coordinates are synchronized with the WooCommerce checkout form before submission.

External services

This plugin includes an optional “Checkout Map” feature. When it is enabled, the customer’s browser connects to the following third‑party services in order to display the map and provide address search:

1) OpenStreetMap Tile Servers (https://tile.openstreetmap.org/)

• Used for: Loading map tiles on the checkout page.
• Data sent: The customer’s IP address and the requested tile coordinates (as part of normal HTTP requests).
• Terms/Policies: https://osmfoundation.org/wiki/Terms_of_Use, https://wiki.osmfoundation.org/wiki/Privacy_Policy, https://operations.osmfoundation.org/policies/tiles/

2) Nominatim (OpenStreetMap) (https://nominatim.openstreetmap.org/)

• Used for: Address/city search in the map geocoder, and looking up an approximate address for the confirmed point so the customer can verify the location they picked. The looked-up address is only displayed; it is not stored and does not modify any checkout field.
• Data sent: The customer’s search query text and the customer’s IP address (as part of normal HTTP requests).
• Terms/Policies: https://operations.osmfoundation.org/policies/nominatim/, https://wiki.osmfoundation.org/wiki/Privacy_Policy

The selected latitude/longitude is saved to the WooCommerce order meta (_delivery_location) only after the customer picks a point on the map and explicitly confirms it with the “ثبت این مکان” button. In the admin order screen, a Google Maps link (https://www.google.com/maps) may be shown for convenience; it is only opened when an admin clicks the link.

No other external requests are made by this plugin. The plugin does not collect or transmit any data about your site or its visitors.

Source code of bundled libraries

The plugin bundles the following third‑party libraries locally (no CDN). Human-readable source code is available at their official repositories:

• Leaflet 1.9.x — https://github.com/Leaflet/Leaflet (BSD-2-Clause)
• Leaflet Control Geocoder — https://github.com/perliedman/leaflet-control-geocoder (BSD-2-Clause)
• Leaflet.Locate — https://github.com/domoritz/leaflet-locatecontrol (MIT)
• QRCode.js — https://github.com/davidshimjs/qrcodejs (MIT)
• Estedad font — https://github.com/aminabedi68/Estedad (SIL OFL 1.1)