module SnipWire - Snipcart integration for ProcessWire

[palacios000]

On 12/4/2020 at 11:05 PM, Gadgetto said:

If you mean the Snipcart version 3 - then it's not supported yet.

Are you planning to support Snipcart v.3 any soon? Thank you for this great peace of work.

[Gadgetto]

On 1/7/2021 at 5:41 PM, palacios000 said:

Are you planning to support Snipcart v.3 any soon? Thank you for this great peace of work.

Compared to v2, there is still one feature missing in v3 of Snipcart:

• Recurring subscriptions

As soon as v3 is feature complete I'll starting development on v3 support.

[BenSlayers]

On 4/21/2020 at 11:22 AM, Gadgetto said:

If you are using another profile or output strategy, you'll need to rewrite the template source.

I'm using the Beginner profile, any chance I could convince one of you coding wizards to show me some example code for snipcart-product.php, snipcart-shop.php, and snipcart-cart.php? I'm definitely not a PHP expert but I'm feeling more and more comfortable in PW every day... I'd really like to get this working but my entire site is already built using the Beginner profile and is currently public, I can't rebuild it using the markup regions output strategy. I have my Snipcart account created, the API test is validated but I have the same issue as reported above by @fruid:

Call to undefined function ProcessWire\ukIcon()

Note: this project is for a non-profit association and I'm currently donating my time but I would 100% not mind paying someone for their help, feel free to PM me if that's preferred ? 

[Jan Romero]

This thread isn’t my place at all, but Gadgetto’s post you quoted tells me you need to copy the file _uikit.php from the regular site profile and somewhere at the top of your own template call include_once('./_uikit.php');. Should be a safe fix for that specific error.

[Gadgetto]

9 minutes ago, Jan Romero said:

This thread isn’t my place at all, but Gadgetto’s post you quoted tells me you need to copy the file _uikit.php from the regular site profile and somewhere at the top of your own template call include_once('./_uikit.php');. Should be a safe fix for that specific error.

Thanks for jumping in @Jan Romero!

This will work but can have side effects.

[Gadgetto]

30 minutes ago, Ben Sayers said:

I'm using the Beginner profile, any chance I could convince one of you coding wizards to show me some example code for snipcart-product.php, snipcart-shop.php, and snipcart-cart.php? I'm definitely not a PHP expert but I'm feeling more and more comfortable in PW every day... I'd really like to get this working but my entire site is already built using the Beginner profile and is currently public, I can't rebuild it using the markup regions output strategy. I have my Snipcart account created, the API test is validated but I have the same issue as reported above by @fruid:

Call to undefined function ProcessWire\ukIcon()

Note: this project is for a non-profit association and I'm currently donating my time but I would 100% not mind paying someone for their help, feel free to PM me if that's preferred ? 

You'll need to have a look at the snipcart-shop and snip cart-product templates and modify them so they use the preferred rendering method.

[BenSlayers]

11 minutes ago, Jan Romero said:

Should be a safe fix for that specific error.

Yup, that worked. Thanks so much @Jan Romero! I can see the demo products now.

2 minutes ago, Gadgetto said:

This will work but can have side effects.

Oh no! Hi @Gadgetto, can you elaborate on the side effects? Basically, I'm trying to add a way for this association to offer paid memberships. I initially tried doing this with @ryan's FormBuilder and Stripe Payment Processor modules but it quickly became too complex for that route. The association's board came up with 9 different membership plans they'd like to offer, some with one user, others with potentially hundreds or more. For instance, when a school registers, they'd like to be able to offer a coupon code to their students so they can register for free, using the school's plan that they paid for. I think the only way I can really make this work is using a cart system so I can enable coupon codes. If you're interested, I can PM you links to the mock-ups I've created that might help shed some light on what I'm trying to do.

[Gadgetto]

@Ben Sayers:

Hey Ben,

that's what I meant - simply including _uikit.php won't do the job. The whole templates are built using UIKit CSS framework.

You'll need to write your own templates for product overview and product-details. If you have a look at the two sample templates which are installed by SnipWire installer, you will see how it works. Please have a look at the comments in the php files.

I currently don't have the time to write sample code based on your rendering method. But if you are familiar with ProcessWire development this should be an easy job.

Having a look at the snipcart-shop template, all in all, that's all you need:
(please note this is a quick composition of the required code and might not fully work. And you need to use your own CSS classes based on your framework)

<!--
The content element holds your products catalogue.
-->
<div id="content">
    <?php
    $products = page()->children('limit=9');
    echo productOverview($products); 
    ?>
</div>

<?php
/**
 * Render a shop product overview
 *
 * @param PageArray $products
 * @return string
 *
 */
function productOverview(PageArray $products) {

    if (!$products->count) return '';
    
    $out = '<div class="product>';

    foreach ($products as $product) {
        
        // We use the first image in snipcart_item_image field for demo
        $imageMedia = '';
        if ($image = $product->snipcart_item_image->first()) {
            $productImageMedium = $image->size(600, 0, array('quality' => 70));
            $imageDesc = $productImageMedium->description ? $productImageMedium->description : $product->title;
            $imageMedia = '<img src="' . $productImageMedium->url . '" alt="' . $imageDesc . '">';
        } else {
            $imageMedia = 
            '<div title="' . __('No product image available') . '">' . 
                ukIcon('image', array('ratio' => 3)) . // you need to use your own image output function here because ukIcon is based on UIKit CSS
            '</div>';
        }
        
        // This is the part where we render the Snipcart anchor (buy button)
        // with all data-item-* attributes required by Snipcart.
        // The anchor method is provided by MarkupSnipWire module and can be called 
        // via custom API variable: $snipwire->anchor()
        $options = array(
            'label' => ukIcon('cart'), // use your own image output function
            'class' => 'button button-primary',
            'attr' => array('aria-label' => __('Add item to cart')),
        );
        $anchor = wire('snipwire')->anchor($product, $options);
        
        // Get the formatted product price.
        // The getProductPriceFormatted method is provided by MarkupSnipWire module and can be called 
        // via custom API variable: $snipwire->getProductPriceFormatted()
        $priceFormatted = wire('snipwire')->getProductPriceFormatted($product);

        $out .=
        '<a href="' . $product->url . '">' .
            '<div class="product-detail">' .
                '<div class="media-top">' .
                    $imageMedia .
                '</div>' .
                '<div class="card-body">' .
                    '<h3 class="card-title">' . $product->title . '</h3>' .
                    '<p>' . $product->snipcart_item_description . '</p>' .
                '</div>' .
                '<div class="card-footer">' .
                    $anchor .
                    '<span class="align-right text-primary">' . $priceFormatted . '</span>' .
                '</div>' .
            '</div>' .
        '</a>';
    }

    $out .= '</div>';

    return $out;
}
?>

 

[BenSlayers]

8 minutes ago, Gadgetto said:

Having a look at the snipcart-shop template, all in all, that's all you need:
(please note this is a quick composition of the required code and might not fully work. And you need to use your own CSS classes based on your framework)

@Gadgetto thank you very much for taking your time to provide that example. I'll kick it around and see what I can do. Cheers ?

[BenSlayers]

Hi @Gadgetto, I finally have a working demo (see it here) using the Beginner Profile that is incorporated with my custom design but I have a few questions:

1. Where is the data saved for custom fields? I added some custom fields and completed a transaction but I don't see any of the custom field data saved anywhere in Setup -> SnipWire -> Customers or in my Snipcart account.
2. Is there a hook I can use to replace the "Order Info" with "Member Info" in the tab label?
3. I'm using SnipWire to sell Membership plans and I'm hoping to have them renew automatically using the subscription option, I don't see any information in your documentation on this, can you provide an example?
4. Is there a way to set a default option on a select field in the Billing Address? This association is only for Michigan (US) so I'd like to set that as the default under the State/Province field.
5. Is there a way to use conditional custom fields depending on the product that is selected? I'm hoping to be able to add/hide certain *required* & optional fields on the Order Info and Billing Address tabs as some membership plans are for businesses and others are for individuals. Each product will likely have custom requirements so if I can create some sort of if/else statement, that would be great.

EDIT: Is there anyone out there that can help? All suggestions are welcome! ?

Edited March 2, 2021 by Ben Sayers
Need Help

[bernhard]

On 5/15/2019 at 4:17 PM, Gadgetto said:

Snipcart is a powerful 3rd party, developer-first HTML/JavaScript shopping cart platform. SnipWire is the missing link between Snipcart and the content management framework ProcessWire.
With SnipWire, you can quickly turn any ProcessWire site into a Snipcart online shop. The SnipWire plugin helps you to get your store up and running in no time. Detailed knowledge of the Snipcart system is not required.

Could anybody having experience with this module please explain what the module EXACTLY does? I don't really get it from the description. And SnipCart itself claims this:

Quote

Add a shopping cart to any website

Start accepting international payments in minutes.

As I understood it's as simple as adding custom button markup to the site and you are up and running your snipcart site. The dashboard in this case would obviously be hosted at snipcart and not inside my processwire project, but is that the only reason for this module? I have the feeling that I must be missing something ? 

Thx for your insights!

Quote

With SnipWire, you can quickly turn any ProcessWire site into a Snipcart online shop

As far as I understood I don't need SnipWire for that?!

Quote

The SnipWire plugin helps you to get your store up and running in no time.

Well... what exactly takes time if I am NOT using SnipWire? Isn't it just adding snipcart buttons?

Quote

SnipWire is the missing link between Snipcart and the content management framework ProcessWire.

Which link is missing? I thought the missing link were just some data-attributes?

<button class="snipcart-add-item"
  data-item-id="starry-night"
  data-item-price="79.99"
  data-item-url="/paintings/starry-night"
  data-item-description="High-quality replica of The Starry Night by the Dutch post-impressionist painter Vincent van Gogh."
  data-item-image="/assets/images/starry-night.jpg"
  data-item-name="The Starry Night">
  Add to cart
</button>

https://docs.snipcart.com/v3/setup/products

[Gadgetto]

1 hour ago, bernhard said:

As I understood it's as simple as adding custom button markup to the site and you are up and running your snipcart site. The dashboard in this case would obviously be hosted at snipcart and not inside my processwire project, but is that the only reason for this module? I have the feeling that I must be missing something ? 

• SnipWire integrates the Snipcart dashboard into your ProcessWire backend
• SnipWire installs all necessary fields for setting up your products editor (> 22 different fields)
• it automatically generates the necessary Snipcart anchor markup based on those fields
• SnipWire provides an easy way to integrate the Snipcart shopping cart into your project (including cart button, customer profile, login, logout, ...)
• provides sample templates to setup your online shop.
• handles and calculates all of the different VAT handlings worldwide
• handles multi currency
• process refunds right from your ProcessWire back-end
• process abandoned carts and send messages to customers right from the ProcessWire back-end
• provides hookable ProcessWire events for orders, customer registration, ...
• ...

How would you handle the custom data attributes markup without an engine generating it? If you only have a handful products this might be possible by writing the markup by hand but if your client should be able to manage a shop, SnipWire is the best way to do it.

As a sample - how would you do this manually?

<button
  class="snipcart-add-item uk-button uk-button-primary"
  title="Add to cart"
  aria-label="Add item to cart"
  data-item-name="Festish Wet Warmer"
  data-item-id="1713"
  data-item-price='{"usd":"22.20","eur":"19.90"}'
  data-item-url="http://domain.com/snipcart-shop/festish-wet-warmer/"
  data-item-description="A short product description..."
  data-item-image="http://domain.com/site/assets/files/1713/beer2.65x65-hidpi.jpg"
  data-item-categories="Beer"
  data-item-metadata='{"id":1713,"created":1563363120,"modified":1580402487,"published":1563363120,"created_users_id":41,"modified_users_id":41}'
  data-item-quantity="1"
  data-item-quantity-step="1"
  data-item-stackable="true"
  data-item-taxable="true"
  data-item-taxes="10% VAT"
  data-item-has-taxes-included="true"
  data-item-shippable="true">
      <span uk-icon="icon: cart"></span> Add to cart
</button>

 

I probably don’t get your message, but as an experienced developer you should get the benefit.

[bernhard]

Thx @Gadgetto

my message was not meant as criticism. I just don't get WHY SnipWire does all that. Ok, I get that you need to setup some fields that hold necessary data (vat, description, image) and then you need to create the markup. That should be quite simple though without using SnipWire (for example using RockMigrations which you can guess I'm using in every project ? ). The cart-button could then look somewhat like this:

<button
  class="snipcart-add-item uk-button uk-button-primary"
  title="Add to cart"
  aria-label="Add item to cart"
  data-item-name="<?= $page->title ?>"
  data-item-id="<?= $page->id ?>"
  data-item-price='<?= $page->price ?>'
  data-item-url="<?= $page->httpUrl ?>"
  data-item-description="<?= $page->description ?>"
  ...>
  <span uk-icon="icon: cart"></span> Add to cart
</button>

Ok... I get that's quite tedious and having a helper method for that could for sure be handy. What I still don't get is why you took all that effort to get all (or at least many?) of the features of snipcart into the pw backend? Wouldn't it be a lot easier if the clients just managed their snipcart shop via the snipcart website? As far as I understood the client has to register an account there and then gets a login where he/she can manage their products/sold items etc?

It's obvious that SnipWire can do a lot and I'm quite impressed - I'm just not getting the WHY behind all that. Maybe it's just because I don't know anything of the PAIN you are solving because I've never setup a snipcart store manually...

[Gadgetto]

5 hours ago, bernhard said:

Thx @Gadgetto

my message was not meant as criticism. I just don't get WHY SnipWire does all that. Ok, I get that you need to setup some fields that hold necessary data (vat, description, image) and then you need to create the markup. That should be quite simple though without using SnipWire (for example using RockMigrations which you can guess I'm using in every project ? ). The cart-button could then look somewhat like this:

<button
  class="snipcart-add-item uk-button uk-button-primary"
  title="Add to cart"
  aria-label="Add item to cart"
  data-item-name="<?= $page->title ?>"
  data-item-id="<?= $page->id ?>"
  data-item-price='<?= $page->price ?>'
  data-item-url="<?= $page->httpUrl ?>"
  data-item-description="<?= $page->description ?>"
  ...>
  <span uk-icon="icon: cart"></span> Add to cart
</button>

Ok... I get that's quite tedious and having a helper method for that could for sure be handy. What I still don't get is why you took all that effort to get all (or at least many?) of the features of snipcart into the pw backend? Wouldn't it be a lot easier if the clients just managed their snipcart shop via the snipcart website? As far as I understood the client has to register an account there and then gets a login where he/she can manage their products/sold items etc?

It's obvious that SnipWire can do a lot and I'm quite impressed - I'm just not getting the WHY behind all that. Maybe it's just because I don't know anything of the PAIN you are solving because I've never setup a snipcart store manually...

If you only need/want to render the Snipcart anchors/buttons then you could do it by simply using php and ProcessWire output (but for example handling VAT splitting and multi currency will be another thing).

For all other things I listed above, SnipWire will do the job for you. 

[BenSlayers]

Hi I'm curious if there are any developers out there that have experience with SnipWire who might be available to hire? I already have the module installed and integrated with the client's Stripe account. This is a non-profit company that would like to offer 9 different membership plans. Everything is working for the basic plan but there are some advanced options that I'll need some assistance with. I've reached out to the developer and I had someone that was going to help but that didn't work out - I do have a description/overview of the project written out which I can forward to you in a DM. From what I understand, this shouldn't be too terribly difficult for an experienced programmer. Thank you! ?

[JayGee]

On 1/9/2021 at 12:14 PM, Gadgetto said:

Compared to v2, there is still one feature missing in v3 of Snipcart:

• Recurring subscriptions

As soon as v3 is feature complete I'll starting development on v3 support.

Hi @Gadgetto - just wondering if you have or are thinking of doing any more work on the V3 support for your module?

[sz-ligatur]

Hello @Gadgetto, 

first of all my big thanks for your work on this useful module. The first steps were a pleasure, but now questions of detail arise here and there.

1) An error message concerns the function [Update order] in the backend - if fopen() is not active here, cURL is used for PUT. The following error complains about RAW Data in this context:
"Raw data option with CURL not supported for PUT".
phpinfo: cURL is enabled in version 7.64.0, PHP 7.4, processwire 3.0.165

I was able to work around the error by setting allow_url_fopen to on, but wonder why the error occurs when using cURL - does this need a fix?
As Ryan notes [post], you can expect fopen() to be disabled more often on hosting servers in the future.

2) I'm using the "deferred payments" option and it would be helpful to be able to set the payment status in the SnipWire admin. Is there a good reason why you did not implement this feature? e.g. "Mark as paid", (or the whole set of possible values: Paid, Deferred, PaidDeferred, ChargedBack, Refunded, Paidout, Failed, Pending, Expired, Cancelled, Open, Authorized).

3) SnipCart sends the webhook order.notification.created on various events - but on SnipWire side it is ignored/not registered. So SnipCart receives a 400 and reports an error. I guess this log-message matching was not a top priority, but for the user it leads to uncertainty if the log data in SnipWire is not completely the same as in SnipCart. Especially since the "Mark as Paid" feature is not available in SnipCart - the timestamp for setting this flag is well worth logging in the notifications section for the store owner I think.

I would appreciate your feedback - and of course I'm also interested in what the further plans are on your side for the module (in terms of feature extension or also support for SnipCart v3 etc.).

Thanks again!
Sebastian

[bbeer]

Hi all
I have a very strange behavior with the translation of SnipWire. For example I've translated following block.

$boxes = array(

'sales' => $this->_('Sales'),

'orders' => $this->_('Orders'),

'average' => $this->_('Average Order'),

'customers' => $this->_('Customers'),

);

Orders and Customer are being translated. The Translations of Sales and Average Order are simply ignored. I am a bid lost here. Anyone any idea what this could be? 

Setup:
PW 3.0.179 after updating
SnipWire 0.8.7
PHP 7.4

Your help is much appreciated!

[flydev]

Did you try without SnipWire ?

Without it, I confirm that the four strings are translatable (on pw-3.0.193).

[bbeer]

Hi flydev

I had that testet. I guess this somehow must have to do with SnipWire, but I reallly don't know why!

[froot]

I cannot delete the SnipWire dashboard page, I get:

PagesTrash: Page /trash/1029.2.2_snipwire/custom-cart-fields/ (1030) cannot be deleted: it has “system” and/or “systemID” status 

I also tried to uncheck the 'system' checkboxes of the page-settings but that does not help. (discussed here).

Here's the long story.
Because I've developed a custom shop module I'm in the process of deleting SnipWire completely, so far with no success though. What's the right procedure? Here's what I do, does that make sense?

remove unused SnipWire fields from templates
unlink templates currently linked to SnipCart for indexing
delete SnipWire templates
delete SnipWire fields (some I re-use in my code, so I merely re-name those fields)
delete SnipWire TaxSelector (fieldtype)
delete SnipWire Markup (module)
delete SnipWire Dashboard (module)
delete SnipWire (module – can I just delete this one and it takes care of everything else?)

thanks for help!

EDIT: OK, turns out when updating to PW version 3.0.200 I get a

System Override: Override (must be added temporarily in its own save before system status can be removed) 

option in the field's settings (or where ever). When checked and saved, then I can uncheck the system checkbox. Then I can delete.
Maybe that helps someone else in the future, anyways, thanks for nothing I guess ?

[doolak]

Hi all,

I know, this module has not been updated for a long time, but I wanted to give it a try and installed it. There was one PHP error, as I installed it on a PHP 8.1 Webspace, but this could be fixed easily. Everything seems to work fine (Dashboard etc.), but when I click on a "Add to cart" - button, nothing happens. There is no error shown. 

So I had a look at the sourcecode and as far as I can see there is some Javascript/JQuery necessary to fire that button. But no Javascript is included in the template folder, just in the admin area. Has anybody an idea how to get this work?

Kind regards, Christian

[doolak]

I got it working by adding the Javascript manually. This module is so great - it should be continued! Great work, @Gadgetto!!!

Hope you will find the time to continue developing.

Another question: As you live in Austria - do you have any German Translation for it?

Cheers, Christian

[Gadgetto]

Hey guys,

I'm indeed starting further development on this module in the next days! It needs a lot of work to be done. The main part will be the transition to Snipcart 3.0 engine + a robust EU VAT tax integration. As usual I'll report the progress to this thread.

Please stay tuned!

Greetings,
Martin

[Gadgetto]

12 hours ago, doolak said:

Another question: As you live in Austria - do you have any German Translation for it?

Sorry, no German translation available. I'm planning to put the language package on Crowdin - but I need to figure out the best way to do this under ProcessWire.

In MODX for example, all language strings are collected in single files...

Edit:
It seems since PW 3.0.181 it is possible to ship your modules with additional translation files inside a languages folder!