Fulfiller Wiki - User contributions [en]

New Product

2024-08-26T13:00:27Z

104.0.66.28:

- Add to product_category table

- Add to prod_group table. Need estimate of ratio of product cost to customs value for ship_mult value.

- Add to provider_product table (if provider using skus or order item specs not already found in product_info)

- Add packaging (all packaging for different order sizes)

Dimension, weight

packaging table (if using new branded packaging or packaging not already on file)
packaging_product table (to map new product to packaging)
provider_packaging table (if provider has reportable packaging skus)

- Add records to product_info for all variants

Product price to provider
Variant weight
Dimensions (only if using size to determine packaging)
Ship description (if different from its product group)

- Set up routing to routing and/or spec_routing tables

- Add to location table where it will be handled (do this last)

- Add product group to access table if departmental access code is used

- Choose a production workstation and install production software (if not already installed)

- Choose a ship workstation and add product group to /Fulfiller/scripts/config.json

- Set up daily reporting as requested or according to similar products

Production development notes:

- If code is added or excluded based on provider this should be done instead through configuration options in assembly.json rather than via provider checks in production code.

Workstation Setup

2024-08-26T12:41:44Z

104.0.66.28:

'''Windows Workstation PHP Setup'''

- Download PHP latest non-thread safe

:https://windows.php.net/download

- Unzip to C:\php

- Copy php.production.ini to php.ini

- In php.ini uncomment these to enable extensions

:extension=curl

:extension=fileinfo

:extension=gd

:extension=openssl

:extension=soap

:extension=mbstring

:extension=exif

- Download CA certificates needed for OpenSSL

:https://curl.se/docs/caextract.html

- Place new new \php\certs folder

- Edit php.ini modifying these entries with the cert file location

:curl.cainfo = \php\certs\cacert.pem

:openssl.cafile = \php\certs\cacert.pem

----
'''Windows Workstation Additional Setup'''

- Install Programmer’s Notepad (or Notepad++)

- Install Chrome and create a shortcut to http://app.fulfillerapp.net/live/app

- Install baretail (in \Fulfiller)

- Set the Windows desktop to a solid color (for faster AnyDesk loading)

----
'''Windows Production Image Magick Setup (when required for product)'''

- Downloaded and install Image Magick 8bit latest

:https://imagemagick.org/script/download.php#windows

- Download PHP Imagick extension

:http://pecl.php.net/package/imagick

- Create folder \php\imagick and copy files downloaded from prior step into it

- Edit php.ini to add this after other extensions
:extension=imagick

- Move/copy \php\imagick\php_imagick.dll to \php\ext

- Add \php\imagick to PATH environment variable

----
'''Windows Production ExifTool (when color profiles required for product)'''

- Download 64-bit Windows exiftool

:https://exiftool.org/index.html

- Move/rename to \Fulfiller\exiftool

- Rename exiftool(-k) to exiftool

----
'''Mac Production Workstation'''

- Install Chrome

:Create bookmark for Fulfiller Admin

- Install Microsoft Visual Studio Coden

- Install Homebrew

:https://brew.sh/

- Install PHP 7.2

:brew install php@7.2

:use recommended PATH modification commands

:path is: /usr/local/opt/php@7.2/bin/php

- Connect to server for cutline common location (if used)

:Add server volume to Login Items

- Set security options

:System Preferences > Security & Privacy > Privacy > Full Disk Access

:Add php: Finder->Go to folder for php executable

:Add convert (or it's original) (if not using native GD for text)

:Add Terminal

:Add Atom

:Add sh (/bin/sh)

- Configure a suitable machine name for sharing

- Share Fulfiller folder with everyone

- Install scripts

:in ~/Library/LaunchAgents

:launchctl load ~/Library/LaunchAgents/fulfiller.process.rb_gloss-sticker.plist

- Configure screen lock, sleep, desktop color

- Remove unused icons from dock

- Place third-party and includes

Workstation Setup

2024-08-26T12:41:24Z

104.0.66.28:

Workstation Setup

2024-07-16T01:03:50Z

104.0.66.28:

'''Windows Workstation PHP Setup'''

- Download PHP latest non-thread safe

:https://windows.php.net/download

- Unzip to C:\php

- Copy php.production.ini to php.ini

- In php.ini uncomment these to enable extensions

:extension=curl

:extension=fileinfo

:extension=gd

:extension=openssl

:extension=soap

:extension=mbstring

:extension=exif

- Download CA certificates needed for OpenSSL

:https://curl.se/docs/caextract.html

- Place new new \php\certs folder

- Edit php.ini modifying these entries with the cert file location

:curl.cainfo = \php\certs\cacert.pem

:openssl.cafile = \php\certs\cacert.pem

----
'''Windows Workstation Additional Setup'''

- Install Programmer’s Notepad (or Notepad++)

- Install Chrome and create a shortcut to http://app.fulfillerapp.net/live/app

- Install baretail (in \Fulfiller)

- Set the Windows desktop to a solid color (for faster AnyDesk loading)

----
'''Windows Production Image Magick Setup (when required for product)'''

- Downloaded and install Image Magick 8bit latest

:https://imagemagick.org/script/download.php#windows

- Download PHP Imagick extension

:http://pecl.php.net/package/imagick

- Create folder \php\imagick and copy files downloaded from prior step into it

- Edit php.ini to add this after other extensions
:extension=imagick

- Move/copy \php\imagick\php_imagick.dll to \php\ext

- Add \php\imagick to PATH environment variable

----
'''Mac Production Workstation'''

- Install Chrome

:Create bookmark for Fulfiller Admin

- Install Microsoft Visual Studio Coden

- Install Homebrew

:https://brew.sh/

- Install PHP 7.2

:brew install php@7.2

:use recommended PATH modification commands

:path is: /usr/local/opt/php@7.2/bin/php

- Connect to server for cutline common location (if used)

:Add server volume to Login Items

- Set security options

:System Preferences > Security & Privacy > Privacy > Full Disk Access

:Add php: Finder->Go to folder for php executable

:Add convert (or it's original) (if not using native GD for text)

:Add Terminal

:Add Atom

:Add sh (/bin/sh)

- Configure a suitable machine name for sharing

- Share Fulfiller folder with everyone

- Install scripts

:in ~/Library/LaunchAgents

:launchctl load ~/Library/LaunchAgents/fulfiller.process.rb_gloss-sticker.plist

- Configure screen lock, sleep, desktop color

- Remove unused icons from dock

- Place third-party and includes

Workstation Setup

2024-07-16T01:03:19Z

104.0.66.28:

'''Windows Workstation PHP Setup'''

- Download PHP latest non-thread safe

:https://windows.php.net/download

- Unzip to C:\php

- Copy php.production.ini to php.ini

- In php.ini uncomment these to enable extensions

;extension=curl

;extension=fileinfo

;extension=gd

;extension=openssl

;extension=soap

;extension=mbstring

;extension=exif

- Download CA certificates needed for OpenSSL

:https://curl.se/docs/caextract.html

- Place new new \php\certs folder

- Edit php.ini modifying these entries with the cert file location

:curl.cainfo = \php\certs\cacert.pem

:openssl.cafile = \php\certs\cacert.pem

----
'''Windows Workstation Additional Setup'''

- Install Programmer’s Notepad (or Notepad++)

- Install Chrome and create a shortcut to http://app.fulfillerapp.net/live/app

- Install baretail (in \Fulfiller)

- Set the Windows desktop to a solid color (for faster AnyDesk loading)

----
'''Windows Production Image Magick Setup (when required for product)'''

- Downloaded and install Image Magick 8bit latest

:https://imagemagick.org/script/download.php#windows

- Download PHP Imagick extension

:http://pecl.php.net/package/imagick

- Create folder \php\imagick and copy files downloaded from prior step into it

- Edit php.ini to add this after other extensions
:extension=imagick

- Move/copy \php\imagick\php_imagick.dll to \php\ext

- Add \php\imagick to PATH environment variable

----
'''Mac Production Workstation'''

- Install Chrome

:Create bookmark for Fulfiller Admin

- Install Microsoft Visual Studio Coden

- Install Homebrew

:https://brew.sh/

- Install PHP 7.2

:brew install php@7.2

:use recommended PATH modification commands

:path is: /usr/local/opt/php@7.2/bin/php

- Connect to server for cutline common location (if used)

:Add server volume to Login Items

- Set security options

:System Preferences > Security & Privacy > Privacy > Full Disk Access

:Add php: Finder->Go to folder for php executable

:Add convert (or it's original) (if not using native GD for text)

:Add Terminal

:Add Atom

:Add sh (/bin/sh)

- Configure a suitable machine name for sharing

- Share Fulfiller folder with everyone

- Install scripts

:in ~/Library/LaunchAgents

:launchctl load ~/Library/LaunchAgents/fulfiller.process.rb_gloss-sticker.plist

- Configure screen lock, sleep, desktop color

- Remove unused icons from dock

- Place third-party and includes

New Product

2024-07-10T01:17:20Z

104.0.66.28:

- Add to prod_group table. Need estimate of ratio of product cost to customs value for ship_mult value.

- Add to provider_product table (if provider using skus or order item specs not already found in product_info)

- Add to product_category table

- Add packaging (all packaging for different order sizes)

Dimension, weight

packaging table (if using new branded packaging or packaging not already on file)
packaging_product table (to map new product to packaging)
provider_packaging table (if provider has reportable packaging skus)

- Add records to product_info for all variants

Product price to provider
Variant weight
Dimensions (only if using size to determine packaging)
Ship description (if different from its product group)

- Set up routing to routing and/or spec_routing tables

- Add to location table where it will be handled (do this last)

- Add product group to access table if departmental access code is used

- Choose a production workstation and install production software (if not already installed)

- Choose a ship workstation and add product group to /Fulfiller/scripts/config.json

- Set up daily reporting as requested or according to similar products

Production development notes:

- If code is added or excluded based on provider this should be done instead through configuration options in assembly.json rather than via provider checks in production code.

Workstation Setup

2023-08-02T01:33:25Z

104.0.66.28:

'''Windows Workstation PHP Setup'''

- Download PHP latest non-thread safe

:https://windows.php.net/download

- Unzip to C:\php

- Copy php.production.ini to php.ini

- In php.ini uncomment these to enable extensions

:extension=curl

:extension=gd

:extension=openssl

:extension=soap

:extension=mbstring

:extension=exif

- Download CA certificates needed for OpenSSL

:https://curl.se/docs/caextract.html

- Place new new \php\certs folder

- Edit php.ini modifying these entries with the cert file location

:curl.cainfo = \php\certs\cacert.pem

:openssl.cafile = \php\certs\cacert.pem

----
'''Windows Workstation Additional Setup'''

- Install Programmer’s Notepad (or Notepad++)

- Install Chrome and create a shortcut to http://app.fulfillerapp.net/live/app

- Install baretail (in \Fulfiller)

- Set the Windows desktop to a solid color (for faster AnyDesk loading)

----
'''Windows Production Image Magick Setup (when required for product)'''

- Downloaded and install Image Magick 8bit latest

:https://imagemagick.org/script/download.php#windows

- Download PHP Imagick extension

:http://pecl.php.net/package/imagick

- Create folder \php\imagick and copy files downloaded from prior step into it

- Edit php.ini to add this after other extensions
:extension=imagick

- Move/copy \php\imagick\php_imagick.dll to \php\ext

- Add \php\imagick to PATH environment variable

----
'''Mac Production Workstation'''

- Install Chrome

:Create bookmark for Fulfiller Admin

- Install Microsoft Visual Studio Coden

- Install Homebrew

:https://brew.sh/

- Install PHP 7.2

:brew install php@7.2

:use recommended PATH modification commands

:path is: /usr/local/opt/php@7.2/bin/php

- Connect to server for cutline common location (if used)

:Add server volume to Login Items

- Set security options

:System Preferences > Security & Privacy > Privacy > Full Disk Access

:Add php: Finder->Go to folder for php executable

:Add convert (or it's original) (if not using native GD for text)

:Add Terminal

:Add Atom

:Add sh (/bin/sh)

- Configure a suitable machine name for sharing

- Share Fulfiller folder with everyone

- Install scripts

:in ~/Library/LaunchAgents

:launchctl load ~/Library/LaunchAgents/fulfiller.process.rb_gloss-sticker.plist

- Configure screen lock, sleep, desktop color

- Remove unused icons from dock

- Place third-party and includes

New Provider

2023-07-11T16:35:08Z

104.0.66.28:

== Production Workstations ==

See New Provider Wiki page.

== Ship Workstations ==

- Ask the provider these questions:

What is the shipping "from" name and phone number?

What is the shipping return name, phone number, and address?

- Create a new provider-<provider>.json file to configure the from info, return info, and shipping accounts.

== Code ==

- If provider is not explicitly specifying shipping (carrier and service), then create the appropriate PHP source file lib/shipspec_<provider>.inc.php

- If provider has a specific notification API, then implement in lib/notify_<provider>.inc.php

== Reporting ==

- Set up semimonthly volume and detail reports for billing

- Set up daily volume reports (for people who want/allowed to have financials)

- Set up daily received reports (for people who don't need/allowed to have financials)

== Database ==

- Add record to provider table (see below)

- If provider is using our API, add a key to api_key table

- Add csr record to access table

== Provider Table ==
name - How provider is referred to in code and database. All lowercase. Not too long.

display - Display name for provider.

explicit_ship - Does provider explicitly specify the shipping carrier and service?

combine_ship - Does provider use combined_shipments?

cache_assets - Should artwork be cached? Useful for providers that expire artwork quickly.

check_mins - How often to check that orders have been received from provider. Zero is don't check.

notify_status - What status states should be notified to provider (production,pending,shipped,cancel,error)

New Provider

2023-07-11T14:38:31Z

104.0.66.28:

== Production Workstations ==

== Ship Workstations ==

== Code ==

- If provider is not explicitly specifying shipping (carrier and service), then create the appropriate PHP source file lib/shipspec_<provider>.inc.php

- If provider has a specific notification API, then implement in lib/notify_<provider>.inc.php

== Reporting ==

- Set up semimonthly volume and detail reports for billing

- Set up daily volume reports (for people who want/allowed to have financials)

- Set up daily received reports (for people who don't need/allowed to have financials)

== Database ==

- Add record to provider table (see below)

- If provider is using our API, add a key to api_key table

- Add csr record to access table

== Provider Table ==
name - How provider is referred to in code and database. All lowercase. Not too long.

display - Display name for provider.

explicit_ship - Does provider explicitly specify the shipping carrier and service?

combine_ship - Does provider use combined_shipments?

cache_assets - Should artwork be cached? Useful for providers that expire artwork quickly.

check_mins - How often to check that orders have been received from provider. Zero is don't check.

notify_status - What status states should be notified to provider (production,pending,shipped,cancel,error)