Skip to content

Latest commit

 

History

History
149 lines (105 loc) · 7.76 KB

README.md

File metadata and controls

149 lines (105 loc) · 7.76 KB
Raw

Swift by DynamicWeb

Swift is a plug-and-play standard solution which allows you to create beautiful mobile-friendly websites. It is fast and easy to build ecommerce sites on Dynamicweb for both B2C and B2B. Using configuration and almost no coding.

GitHub tag (latest by date) GitHub DW GitHub Bootstrap GitHub DW

Key features • Installation • Requirements • Hosting & Install DW • Database • License

alt text

Key features

  • Mobile first 📱, responsive, scaleable and content resilient rendering. Ensuring painless mobile experience.
  • Lighthouse 95+ points 💯 performance optimized implementation, ensuring users do not churn
  • SEO 📝 is build in using content and product data
  • Build designed pages 🎨 using visual drag and drop to create your content
  • Web Accessibility Guidelines (WCAG) 🏆 Level AA compliance, make web content more accessible
  • World Wide Web (W3C) 🌐 validated following website formatting standards
  • Visual editor 🌈 building content pages, product list and product detail pages in a visual manner and with components

alt text

Installation

Swift is installed on top of a Dynamicweb application. This repository contains a ./Files with design files, images, and other static resources

The basic install procedure is:

  1. Prepare the hosting environment
  2. Install the DynamicWeb application
  3. Set up a website in IIS Manager and add the Swift-folder as a virtual directory
  4. Download the Swift Product Image folder and insert the folder here Swift/Files/Files/Images/Products
  5. Build the Swift design
  6. Install the Swift database & connect solution to it
  7. Log in and install a license

Requirements

  • Swift 1.23.0 requires DynamicWeb version 9.15.13 or newer
  • Swift 1.22.0 requires DynamicWeb version 9.15.9 or newer
  • Swift 1.21.0 requires DynamicWeb version 9.15.5 or newer
  • Swift 1.20.0 requires DynamicWeb version 9.15.4 or newer

See requirements for older Swift versions here

  • The baseline database is a bacpac file created using the Microsoft SQL Server 2016 standard (version SQL server 15.0.2080.9) using SQL Server Management Studio 2019 version 15.018040.0.

Hosting environment and DynamicWeb install

Swift must be installed on a server or local machine running Windows and a recent DynamicWeb application.

Links
DW9 Software/Hardware requirements
Hosting Preparing the hosting environment
Install Dynamicweb

After following these guides you will have a freshly installed DynamicWeb solution, which is ready to run Swift.

Swift database and product images

Download
Database Swift Demo database
Database Swift Empty database
Image folder Swift Product Image

Add Swift-folder as virtual directory

To use the Swift-design you must add the Files-folder from this repository as a virtual folder for the website you created in IIS Manager:

  1. Open IIS Manager and locate the website
  2. Right-click the website and click Add virtual directory
  3. Write Files in the Alias-field
  4. Enter the physical path to the Swift ./Files folder
  5. Click OK

This sets the downloaded ./Files folder as a virtual directory for the website, which means that you can easily upgrade the DynamicWeb application without having to move the .\Files folder every time.

Install Node.js and build design

Swift uses webpack to calculate dependencies and bundle scripts, images and other assets. This means that the design must be built after being cloned:

  1. Download and install Node.js
  2. Open a command prompt and navigate to folder Swift is cloned to
  3. Run npm install
  4. Run npm run build:webpack
  5. Run npm run start

Restore database and connect with solution

This repository contains a number of database files .bak or .bacpac - with demo data, e.g. pages, products, demo users, etc. You often want to use these as a starting point for a new Swift project.

To restore the database:

  • Open SQL Management studio and connect to your server
  • Right-click the server and open Properties > Security – verify that Server Authentication is set to SQL Server and Windows authentication mode
  • Right-click the Databases-node and select Import Data-tier Application
  • Select Import from local disk and select the .bacpac file – click next
  • Enter a name and click next

The connection between a solution and a database is stored inside a files called GlobalSettings. This file is part of the repo, so it will be overwritten every time you retrieve the latest version of Swift from here.

To solve this issue consider creating a GlobalSettings.database.config file inside the ./Files folder with the connection details:

<?xml version="1.0"?>
<Globalsettings>
<System>
    <Database>
      <Password>yourpassword</Password>
      <Type>ms_sqlserver</Type>
      <UserName>yourSQLusername</UserName>
      <Database>yourdatabasename</Database>
      <SQLServer>localhost</SQLServer>
      <DWWebIP>
      </DWWebIP>
      <SQLServer2>
      </SQLServer2>
      <Database2>
      </Database2>
      <UserName2>
      </UserName2>
      <Password2>
      </Password2>
      <IntegratedSecurity>False</IntegratedSecurity>
      <ConnectionString>
      </ConnectionString>
      <ConnectionString2>
      </ConnectionString2>
    </Database>
</System>
</Globalsettings>

Whenever the solution is accessed this file will be used in place of the database node in globalsettings-config – and it will not be overwritten.

Log in and install a license

  • After successfully connecting the database and solution you can go to yoururl.com/admin and log in with the administrator username and password.

  • After logging in you will be asked to Install a license.

  • If you instead see the DynamicWeb Installer the database and solution are not correctly linked. Try recycling the application pool and trying again.