=== McCrossen ArtistFlow® ===
Contributors: mccrossenmarketing
Tags: commissions, artists, portfolio, customer portal, invoicing
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 0.18.10
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Commission lifecycle management for visual artists: intake, proposals, payments, project management, gallery, delivery and reviews.

== Description ==

ArtistFlow runs an artist's commission business inside WordPress: a multi-step commission request form, proposals and payment requests, a project queue with progress updates, delivery tracking, a customer portal, a portfolio gallery and customer reviews. Features and limits follow the site's ArtistFlow license.

ArtistFlow® is a registered trademark of McCrossen Consulting LLC.

== External Services ==

ArtistFlow contacts the services below. Each entry says when. Nothing is sent to a service until the related feature is configured or used.

**McCrossen Marketing platform (mccrossenmarketing.com)**
License and configuration: when a license key is saved or refreshed, twice a day while a key is saved, and when an ArtistFlow admin page is opened after the last check has expired. Sent: the license key, the site domain and URL, plugin and SDK versions, WordPress and PHP versions, the site locale, the installed McCrossen plugins (name, version and whether each is active) and any recorded McCrossen cross-promotion events (event type, plugin, admin page and time). If a license check fails, the error type and message, the HTTP status, the site domain and the plugin, SDK, WordPress and PHP versions are reported, at most once an hour for each kind of error.
Updates: when the platform offers a newer ArtistFlow version, WordPress downloads it from mccrossenmarketing.com. The download address carries a short-lived download token issued for this site and that version, and the site domain; it does not contain the license key.
Description assistant: when the artist uses it in the dashboard, the text being improved (up to 5,000 characters) is sent with the license key and site domain.
Diagnostic report: only when the artist clicks Send Diagnostic Report on the License tab. Sent: the license key, the site domain, ArtistFlow, database, SDK, WordPress and PHP versions, the active plugins and theme, the license tier, feature flags, limits and AI usage, the time of the last license check and the last license error, the server software, PHP memory and time limits, and whether image processing and other McCrossen plugins are available.
Error report: activating ArtistFlow adds a must-use plugin shared by McCrossen plugins (wp-content/mu-plugins/mccm-watchdog.php), and ArtistFlow updates it whenever ArtistFlow itself is updated; a newer copy installed by another McCrossen plugin is left in place. It reports only for a McCrossen plugin whose license key is saved and whose site has connected to the McCrossen Marketing platform: when a page load ends in a fatal PHP error in that plugin's files, or in an error whose message names a McCrossen component, it sends one report per error per hour. Sent: the license key, the site domain, the plugin, WordPress and PHP versions, the active plugins and theme, the error message, and the file path, line and type of the error. The file is removed when no McCrossen plugin that uses it is active.
Terms: https://mccrossenmarketing.com/terms-of-service · Privacy: https://mccrossenmarketing.com/privacy-policy

**Stripe (api.stripe.com)**
Used only when the artist connects a Stripe account under Settings → Online Payments. Creates a hosted checkout session for a deposit or balance payment and reads its status afterwards. Sent: the amount and currency, the commission reference and piece name, the customer's email address and the return URLs. When Stripe reports a refund for a payment ArtistFlow has not recorded, ArtistFlow asks Stripe which checkout the payment came from (the request sends the payment's ID and is authenticated with the site's Stripe secret key), so refunds of other sales on the same Stripe account are ignored.
Terms: https://stripe.com/legal · Privacy: https://stripe.com/privacy

**Cloudflare Turnstile (challenges.cloudflare.com)**
Used only when Turnstile is the selected CAPTCHA provider. Loads the widget on the commission form, portal login and registration, and review forms, and verifies each response server-side. Sent: the response token, the site's secret key and the visitor's IP address.
Terms: https://www.cloudflare.com/website-terms/ · Privacy: https://www.cloudflare.com/privacypolicy/

**Google reCAPTCHA v3 (www.google.com, www.gstatic.com)**
Used only when reCAPTCHA v3 is the selected CAPTCHA provider. Loads Google's script on the same forms, which loads its own files from www.gstatic.com, and verifies each response server-side. Sent: the response token, the site's secret key and the visitor's IP address; the visitor's browser connects to both Google hosts.
Terms: https://policies.google.com/terms · Privacy: https://policies.google.com/privacy

Delivery emails may link to the carrier's public tracking page for a shipment; those links open in the customer's browser and nothing is sent by the plugin.

== Changelog ==

= 0.18.10 =
* Blog posts from gallery pieces and video reference uploads are included on every plan, with or without a license key.
* Junior Artist Mode, active while a Junior Artist account exists: the site administrator reviews every commission request before the Junior Artist sees it, and the Accept/Reject Proposals permission can no longer be granted. System Communication Mode stays on, so every customer conversation stays inside ArtistFlow. Video uploads stay blocked in the form and on the server.
* ArtistFlow no longer says uploads are scanned automatically, and the unused scanning placeholder is removed. Review customer uploads yourself.
* No plan upgrade or license purchase prompts on the dashboard and License tab. AI Enhance and removing the Commission Builder credit line need a connected McCrossen Marketing account; existing license keys keep working.
* The Studio Mode preview and the "coming soon" labels are removed.
* The commission form's file-type error lists video formats only when video is accepted.

= 0.18.9 =
* A partial refund made in Stripe no longer marks the whole invoice as refunded. The invoice stays paid; the refunded amount is added back to the remaining balance, so the final invoice can collect it. A full refund still marks the invoice refunded. Invoice lists and receipts show "Partially refunded" and the amount paid after refunds.
* Refund and dispute alerts are shown only to administrators, only on the ArtistFlow screens, and stay until dismissed. Dismiss clears only the alerts on the screen, even if a new alert arrives at the same moment. Amounts use the currency of the refund or dispute.
* After an update, ArtistFlow finishes its own update steps on the first request of any kind, including after deactivating and re-activating the plugin, and only once when several requests arrive together.
* A payment notice that cannot be saved is reported back to Stripe so Stripe sends it again; so is a refund that arrives before its payment has been recorded. Refunds of other sales on the same Stripe account, or of a payment the invoice is no longer waiting for, are acknowledged and ignored.
* If a payment has gone through but is not yet recorded, opening the pay link again no longer starts a second checkout, and a late expiry notice for an older pay link no longer closes the current one.
* When the payment page cannot be opened, the customer's proposal page now says so and asks them to check back if they have already paid, and the artist's Resend payment link notice says the customer may already have paid.
* Spam protection: a protected form sent without its timing check is refused.
* Permanently deleting an archived commission deletes the customer's reference images, and the confirmation says when gallery pieces made from it will be deleted too.
* The shared error reporter sends nothing until a license key is saved and the site has connected to McCrossen Marketing. ArtistFlow updates it with every plugin update and never replaces a newer copy.
* Completed and canceled requests no longer appear as separate cards on the customer dashboard.
* Help text corrections (registration, email templates, gallery shortcode examples, deactivation). The email placeholder list shows only placeholders that are filled.
* `[artistflow_piece]`: new `gallery_url` attribute for the gallery link.
* More of ArtistFlow can be translated (status labels, license messages, form messages, the builder credit line, payment emails, file counts, checkout descriptions, and every message with more than one value now gives translators numbered placeholders). The text domain is now `mccrossen-artistflow`.
* Uninstall also removes the license-error report limits. Invalid values for the logo URL, reply-to email or colors are saved as empty.
* Database 1.9.4 (one new invoice column).

= 0.18.8 =
* Trademark notice: ArtistFlow is now a registered trademark, so the plugin name, admin menu and page titles, and the first mention in each email and customer-facing page show the ® sign instead of ™. Placement is unchanged.
* Licence notice: the main plugin file carries a copyright line and the standard GNU General Public License notice (version 2 or later), matching the licence already declared in the plugin header and this file.
* Currency: amounts show the currency your Stripe payments use (USD $, EUR €, GBP £, CAD CA$, AUD A$) in emails, the customer portal, the commission form and the admin screens. Previously every amount showed a dollar sign whatever the currency.
* Payment request emails no longer show the amount with two dollar signs. A customized template that writes a currency sign before an amount still shows only one.
* Emails show exactly one ® after ArtistFlow however a customized template wrote the sign. An email whose text is not valid UTF-8 is now sent unchanged instead of losing part of its text.
* Forms and links ignore malformed input instead of failing with an error.
* The deposit field explains that a blank deposit uses the Deposit % from Settings and emails the customer a payment link. The Send Diagnostic Report description lists everything the report contains.
* External Services in this readme now describes everything the plugin sends, including the shared error-report helper and update downloads.

= 0.18.7 =
* Payment emails: the [payment_url] placeholder is always resolved, so a "Proposal Sent" email created without a Stripe link no longer shows the literal placeholder text. The "Payment Request" template now places the pay button as its own block (the button was being written inside the link attribute, which broke the link in every payment request email). The button reads "Pay Now" for a final payment and "Pay Deposit Now" for a deposit. [payment_url] is listed in the template editor's placeholder reference.
* Settings: the unused "From Name" field is removed. The From name of every email comes from the artist name setting (or the site name), and each template's own From name still applies; nothing about sending changes. The write-only legacy Reply-To key is no longer kept on save.
* Security tab: changes to System Communication Mode read "Logged communications turned on/off by <name>" (the user ID is shown when the account no longer exists) under the "Settings" form label; the empty log reads "No security events recorded."

= 0.18.6 =
* Commission requests from visitors who are not logged in are filed only after the owner of the email address confirms them. The form stores the request and emails a confirmation link (new template "Confirm Your Commission Request"); the link opens a confirmation page and only its button sends the request to the artist, under the existing customer for that address or under a new portal account. Unconfirmed requests and their reference files are removed after 7 days. At most 3 unconfirmed requests are accepted per email address and per connection in 24 hours. With portal registration closed, only existing customers can confirm. Logged-in customers submit as before.
* Portfolio import, the review system and email template customization are included on every plan, Free included. The dashboard upgrade note no longer shows a price.
* Trademark notice: the ™ sign appears on the word ArtistFlow in the plugin name, admin menu and page titles, and on the first mention in each email and customer-facing page; elsewhere the name is plain.

= 0.18.5 =
* Emoji characters removed from every screen, form, notice and email template. WordPress rewrites them into images fetched from a third-party CDN, which rendered as broken images on some sites; the plugin now uses plain text and styled markup and leaves the site's own emoji setting alone.
* System Communication Mode footer wording: "Replies to this email address are not received. Please log into the portal to reply to this message." (alerts to the artist name the dashboard instead).
* Database definitions let the upgrader add and alter columns on existing tables (schema 1.9.2). The AI usage table no longer carries the licence key. One review per project is enforced by the database; a repeated submission gets the friendly "already submitted" message.
* A customer's message no longer changes the proposal status; only the artist moves a proposal to "clarifying".
* Settings: the deposit wording in the commission form's terms sentence is editable; the default wording is unchanged.
* Portal registration: the emailed link now opens a confirmation page, and only its button creates the account, so mail scanners and link previews can no longer create it early. Links already sent keep working.

= 0.18.4 =
* System Communication Mode is the logged-communications mode: while it is on, every email, including alerts to the artist, is sent from noreply and carries a link to the portal or dashboard with a line saying replies to the email are not received; per-template Reply-To addresses are kept but not used until it is turned off. The setting is administrator-only and each change is recorded in the security log.
* With System Communication Mode off, Reply-To follows each template's audience: emails to customers use the Settings Transactional Reply-To (noreply when empty); alerts to the artist reply to the customer who triggered them. Per-template Reply-To addresses saved in the editor are kept and still win.
* Template editor: the Reply-To field starts empty and shows the effective address as a placeholder, is disabled while System Communication Mode is on, and the payment request template is now editable.
* Licence declared as GPL-2.0-or-later in the plugin header and this file.
* Removed the unused Settings "Reply-To Email" field.
* Removed the unfinished customer-facing description assistant button from the commission form.
* Code comment and glyph housekeeping.

= 0.18.3 =
* Setting to allow or close customer portal account creation.
* uninstall.php removes stored credentials on plugin deletion; full data deletion is a separate opt-in.

= 0.18.2 =
* Anonymous commission requests no longer overwrite an existing customer's saved name and phone.
* Gallery originals are stored outside the public uploads folder.
* Junior Artist tab marked as coming soon.

= 0.18.1 =
* Portal registration verifies email ownership before an account is linked to an existing customer.
* Image screening copy corrected.

= 0.18.0 =
* Security hardening across forms, uploads and the customer portal.
