Создаем новый NopCommerce проект с подключением PostgreSQL за 5 минут

В рамках этой небольшой статьи я расскажу, как всего за 5 минут и 9 несложных шагов можно создать новый NopCommerce-проект, подключив БД на PostgreSQL.

Краткий экскурс

NopCommerce - мощная и гибкая CMS система c открытым исходным кодом, построенная на ASP.NET (.NET Core), в частности, на архитектуре Model-View-Controller (MVC).

Главные преимущества системы: NopCommerce является полностью бесплатным решением (вы платите только за хостинг, который сами выбираете в дальнейшем), гибкость настройки и кастомизации проектов - можно как угодно менять и дополнять интерфейс и функциональность (создавать свои плагины, выбирать СУБД и т.д.), адаптируя сайт под специфические требования бизнеса.

Среди других характеристик NopCommerce:

• Масштабируемость;

• Возможность SEO-оптимизации;

• Безопасность;

• Возможность интеграций с различными API, платежными системами и т.д.

Таким образом, по многим аспектам мало чем уступает широко известным Wordpress, Shopify и др.

В качестве подключаемой СУБД выбран PostgreSQL (есть альтернативные варианты – SQL Server, MySQL)

Для работы нам понадобится: разумеется, Visual Studio с установленным в ней фреймворком ASP.NET и, конечно же, pgAdmin или другой инструмент для работы с PostgreSQL.

Итак, приступим.

Шаг 1. Скачиваем решение

Сперва нужно скачать "Package with source code" на официальном сайте https://www.nopcommerce.com/en/download-nopcommerce. После распаковки архива, в папке вы найдете файл "NopCommerce.sln" – его открываем в студии.

Шаг 2. Подключаем пакет Npgsql

Через менеджер пакетов NuGet нужно добавить пакет для работы с СУБД PostgreSQL -Npgsql.EntityFrameworkCore.PostgreSQL (last version - 8.0.10), обратите внимание на версию.

Шаг 3. Проверяем подключение пакета в Nop.Data.csproj

Для справки, Nop.Data.csproj - файл, который содержит метаданные о проекте Nop.Data (папка с классами). Его основные задачи:

• Указывает целевую платформу - <TargetFramework>net8.0</TargetFramework> означает, что проект скомпилирован для .NET 8.0.

• Содержит информацию о проекте - о компании, авторах, версии, описании проекта, лицензии, ссылку на репозиторий и т.д.

• В секции <ItemGroup>  будут перечислены все внешние библиотеки и пакеты, необходимые для работы проекта, т.е. файл отвечает за управление зависимостями.

• Конфигурирует сборку, т.е. как компилировать проект, какие файлы включать в сборку, и т.д.

В целом папка Nop.Data является частью ядра NopCommerce и содержит классы и функции для работы с БД.

В файле Nop.Data.csproj ( .../Libraries/Nop.data/Nop.data.csproj) нужно проверить подключение пакета последней версии - <PackageReference Include="Npgsql" Version="8.0.10" />

Шаг 4. Создаем сервер и БД

Далее нужно создать свой сервер и БД (в pgadmin или через терминал), запомните имя сервера, имя БД, порт, пароль. В моем примере - localhost с портом 5432. БД имеет следующие параметры:

Шаг 5. Задаем параметры подключения БД в web.config

 Файл web.config определенно известен всем тем, кто так или иначе работал с ASP.NET -  это конфигурационный файл, который используется в приложениях ASP.NET, в том числе и в NopCommerce. Здесь указывается тип базы данных (SQL Server, MySQL и т.д.), строка подключения, имя пользователя и пароль, определяется аутентификация, авторизация и другие параметры безопасности, указываются HTTP-модули, которые будут использоваться приложением, настраиваются сессии и многое другое. Сейчас нас интересует только подключение БД.

В решении NopCommerce файл можно найти тут: ...\Presentation\Nop.Web\web.config.

Перед закрывающим тегом </configuration> должно быть это:

 <connectionStrings> <add name="NopCommerce.Framework" connectionString="Server=SERVER_NAME; Port=5432;Database=DB_NAME;User Id=USERNAME;Password=YOUR_PASSWORD;" providerName="Npgsql" /></connectionStrings>

Где:

• SERVER_NAME - название вашего сервера;

• DB_NAME – название вашей БД;

• USERNAME – ваше имя пользователя;

• YOUR_PASSWORD – ваш пароль;

Шаг 6. Запускаем проект (Nop.Web), не отключая соединение PostgreSQL

Шаг 7. Заполняем форму первоначальной установки NopCommerce

После запуска проекта, в браузере откроется несложная форма первоначальной установки NopCommerce. В форме введите данные для подключения к базе данных, указав реквизиты своего сервера и БД (= реквизиты в теге <connectionStrings>).

Первоначальная установка длится примерно 1-2 минуты.

Примечание: email выступает в качестве логина, вы можете его придумать.

Шаг 8. Авторизуемся на сайте

Сайт запущен, авторизуйтесь – введите email и пароль, который был указан на предыдущем шаге.

Шаг 9. Зайдем в админку интернет-магазина

Для этого нужно просто добавить /admin в адресную строку.

Вот такой несложный способ!