=== Webwall Proposal Builder ===
Contributors: webwall
Tags: proposals, quotes, estimates, quotation, clients
Requires at least: 6.7
Tested up to: 7.1
Requires PHP: 8.2
Stable tag: 1.0.26
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create professional client proposals in WordPress. Manage clients and services, then preview and print — no WooCommerce required.

== Description ==

Webwall Proposal Builder is a WordPress plugin for creating professional client proposals. Agencies, studios, and independent professionals can manage clients and a service catalog, build a priced proposal, preview the document, and print it — without WooCommerce and without a Pro license.

The free version is a complete proposal workshop, not a teaser. You keep working in the WordPress admin you already use.

= Who it is for =

* Agencies and freelancers who send structured offers, not just a price in an email
* Teams that sell one-off work and recurring retainers in the same proposal
* Sites that need English or Greek administration

= What you can do for free =

* Set company identity (name, contact details, logo, bank details, default currency)
* Manage clients and a reusable service catalog
* Create proposals with line items, quantities, prices, discounts, and descriptions
* Mix one-off and recurring services, including prepayment terms
* Set payment terms and offer terms
* See calculated totals on screen
* Preview the proposal document and print it
* Keep a simple proposal list

= How a proposal is built =

1. Complete the short company setup wizard.
2. Add clients and services (or start a proposal and add items as you go).
3. Edit the proposal: commercial lines, notes, and terms.
4. Preview the document, then print it for the client.

= Pro =

Pro is optional. It unlocks delivery and pipeline tools when you outgrow print-only:

* PDF download
* Email sending
* Email open tracking (first-party pixel on your WordPress site)
* List filters, follow-up / won / lost workflow, and trash
* Version history and compare
* Additional cover themes
* Proposal templates

Upgrading does not copy or migrate proposal data. Existing clients, services, and proposals stay in place.

= Languages =

English is the source language. A Greek translation is included. Admin language follows the WordPress locale.

= Privacy =

Proposal data stays in your WordPress database. Freemius is used only if you opt in, connect an account, or upgrade. See *Privacy / External Services* below.

Install the free version, create one proposal, and print it. That is the product.

== Installation ==

1. Install from Plugins → Add New, or upload the plugin ZIP.
2. Activate Webwall Proposal Builder.
3. If Freemius asks you to connect, you may skip it and continue with the free features.
4. Complete the company setup wizard (identity, logo, defaults).
5. Open Proposals in the WordPress admin.
6. Add clients and services, then create your first proposal.
7. Use Preview to review the document and print it.

== Frequently Asked Questions ==

= Is Webwall Proposal Builder free? =

Yes. You can install it from WordPress.org and use the free proposal workflow without paying. Pro is optional.

= Can I create proposals without Pro? =

Yes. Clients, services, proposal editing, calculations, preview, and print work without a Pro license.

= Can I print proposals in the free version? =

Yes. Open preview and use Print. PDF download is a Pro feature.

= Does it support PDF? =

PDF download is included in Pro. The free version uses on-screen preview and print.

= Can I send proposals by email? =

Email sending is a Pro feature. The free version does not send proposal email.

= Does it track when a proposal is opened? =

Open tracking is Pro, and only after a Pro site sends a tracked email. The free build does not turn tracking on.

= Can I manage clients and services? =

Yes. Both are part of the free version.

= Does it support recurring services? =

Yes. A line item can be one-off or recurring, including prepayment terms. That is available in the free editor.

= Does it support English and Greek? =

Yes. English is the source language. A Greek translation is included. The administration language follows the WordPress locale.

= Does it require WooCommerce? =

No.

= Does it require an external account? =

No. You can skip Freemius connect and use the free features. An account is only needed if you opt in, manage a license, or upgrade.

= What data does Freemius process? =

Only if you opt in, connect, view pricing, or activate a license. See *Privacy / External Services*. Opt-in is not required for the free workflow.

= What happens if I upgrade to Pro? =

Existing clients, services, and proposals stay in the same tables. You gain PDF, email, tracking, filters, workflow, trash, versions, extra cover themes, and templates. Schema version stays 1.

= Can clients approve a proposal on a public page? =

No. This plugin builds and previews the proposal in WordPress. You print it or, with Pro, send a PDF/email. There is no public accept/decline link.

== Screenshots ==

1. New Proposal — select a client and choose one-off or recurring services for a new proposal.
2. Proposals — view your proposal list with client, value, date, edit, and preview actions.
3. Proposal Preview — review the professional proposal document before printing or using Pro delivery features.
4. Clients — manage client companies and their primary contact details.
5. Services — manage your reusable service catalog, including one-off and recurring billing.
6. Company Settings — configure company identity, logo, contact details, currency, and proposal defaults.

== Changelog ==

= 1.0.26 =
* Security: admin forms now sanitize and allowlist each field before it reaches application services.
* Security: privileged actions require both a capability check and a matching nonce.
* Existing proposal data is preserved. Schema version remains 1.

= 1.0.25 =
* Premium Pro features now require a valid paid Freemius license in addition to the premium package.
* Installing the premium ZIP without a license keeps Free capabilities only.
* Existing proposal data is preserved. Schema version remains 1.

= 1.0.24 =
* WordPress.org compliance: Pro implementation is no longer shipped in the free package.
* Security: nonce values are sanitized before verification; runtime files use the uploads directory.
* Dompdf updated to 3.1.6 in the Pro package.
* Existing proposal data is preserved. Schema version remains 1.

= 1.0.23 =
* WordPress.org Plugin Check: no errors or warnings on the free package.
* Freemius uninstall lifecycle compatibility.
* No changes to stored proposal data. Schema version remains 1.

= 1.0.22 =
* Added WordPress-standard readme.txt metadata.

= 1.0.21 =
* Improved compatibility between the setup wizard and Freemius activation flow.

= 1.0.20 =
* Included Freemius SDK for license, account, and update infrastructure.

= 1.0.19 =
* Fresh installations start with an empty service catalog.

= 1.0.18 =
* First-run setup is a 3-step agency wizard.

== Upgrade Notice ==

= 1.0.26 =
Existing proposal data is preserved. Schema version remains 1.

= 1.0.25 =
Existing proposal data is preserved. Schema version remains 1. Premium Pro tools require an active paid license.

= 1.0.24 =
Existing proposal data is preserved. Schema version remains 1. PDF, email, and other Pro tools remain in the separate Pro package.

= 1.0.23 =
Existing proposal data is preserved. Schema version remains 1.

== Privacy / External Services ==

Webwall Proposal Builder stores proposal, client, service, and settings data in your WordPress database. The free version does not send proposal emails and does not enable customer open tracking.

= Freemius =

If you choose to opt in, connect an account, view pricing, or activate a license, the bundled Freemius SDK communicates with Freemius servers (including api.freemius.com and Freemius checkout). That communication can include site URL, plugin version, license/account status, and optional diagnostic data you approve. Opt-in is not required to use the free proposal workflow. You can skip Freemius connect and continue using the free features. Skipping connect does not disable clients, proposals, preview, or print. No Freemius secret key is stored in this plugin. Privacy policy: https://freemius.com/privacy/

= Email open tracking (Pro only) =

Tracked proposal email is a Pro feature. When a Pro site sends a tracked email, the message may include a first-party 1x1 image loaded from this WordPress site (`wwpb_email_open`). Loading that image records an open timestamp and a count against a hashed token already stored for that send. No third-party tracking service is used. The free build cannot send tracked proposal email and does not silently turn tracking on. Historical Pro tracking tables remain in the schema so existing data is not removed.

= WordPress.org updates =

The free directory package receives plugin updates from WordPress.org.
