New: adds UBL as additional output format for documents

[alexmigf]

closes #481

This PR adds support for UBL format in companion with the existing PDF output. This will replace our UBL addon, and future developments on UBL must be done on this plugin instead.

Specs

• Code migrated from the UBL addon to this plugin
• Load sabre\xml dependency and updated to version 2.2.5 (supports PHP 7.1+, min version required for this plugin)
• Detects if the UBL addon is installed and disables it. Also adds a notice stating that and suggesting the addon deletion
• Migrates UBL addon settings to this plugin settings on update to the future 3.6.0 version
• Shows raw xml output on preview when UBL tab is selected in the document settings
• Only Invoice has UBL support by default, other documents can also have it using this hook: https://github.com/wpovernight/woocommerce-pdf-invoices-packing-slips/pull/521/files#diff-b4b45c08877ccc6f215e534426a81b3edd82ce371cfc3fce7420e62e279b3c1eR122

Screenshots

Document settings for UBL format:

UBL output preview:

Taxes classification:

New dynamic action button (can be generated for other UBL documents):

Bulk actions support:

New independent meta box for UBL in the order page:

UBL document settings export/import support:

[MohamadNateqi]

Since you have applied WPCS on the UBL directory, it would be great if you could rename the function to follow the sneak case, or we can create another issue as the changes may be significant.

[MohamadNateqi]

Great work, Alex!
Thank you for your efforts.

[dwalkerpriv]

Works fine on my end. Settings exported and imported without issues as well

[alexmigf]

I was thinking that maybe we should rename the plugin following this implementation. Joe have mentioned this in past meetings, maybe something like this:

• PDF & UBL Invoices & Packing Slips for WooCommerce

But I don't like seeing two & in the title, maybe we should apply a / or a ,?

What do you guys think?

@dwalkerpriv @YordanSoares @MohamadNateqi @Terminator-Barbapapa

[MohamadNateqi]

@alexmigf I agree with you that having two "&" symbols can look cluttered.
I think "PDF/UBL Invoices & Packing Slips for WooCommerce" seems good.

Also, I wanted to say that I like the idea of renaming, as it improves clarity and reflects this new feature that can also be good in terms of SEO, but I'm also sort of worried about the impact of this change as this plugin has been around for years with this name.

[alexmigf]

but I'm also sort of worried about the impact of this change as this plugin has been around for years with this name.

Shouldn't have a huge impact, we have also renamed it recently to change the "for WooCommerce" to the end of the name.

I think we should have some space outside the / because it terms of SEO this reads like this:

• PDF/UBL => PDFUBL
• PDF / UBL => PDF UBL

The second seems better to me.

[MohamadNateqi]

Yeah, having some space around / is better.

[YordanSoares]

This makes me recall that in Spain people often joke about how good is our plugin, but how difficult is to remember its name.

To be honest, if we're willing to rename the plugin, I would prefer to run a brainstorming and look for a branding short name, not a name that states-all-the-document-types-our-plugin-offers.

Then we can mention what our plugin does as a subtitle or within the plugin descriptions in both on WordPress.org and our store. For instance:

• On WordPress.org:
  • NewPluginName - PDF / UBL Invoices & Packing Slips for WooCommerce
• On our store, the new extension names would be shorted and easy to remember and differentiate (our customer often buy a different plugin because I think they get mess with the long names):
  • NewPluginName - Professional
  • NewPluginName - Premium Templates

Here, some naming ideas to start with:

• EasyInvoicing
• QuickInvoice
• FastInvoicing
• InvoicingWise
• WooInvoicing

[alexmigf]

By rename I didn't mean change all name, just a way to include the UBL there somehow. Full rename, or brand rename should be discussed privately in Slack I think, and maybe including the marketing department from UpdraftPlus.

[dwalkerpriv]

In regards to incorporating UBL in the name, "PDF / UBL Invoices & Packing Slips for WooCommerce" is pretty simple and straight forward enough.

[Terminator-Barbapapa]

I think we are there. Awesome work! 🎊