# Base\_Start\_Package

{% hint style="info" %}
Install only template: If you already have an existing Magento website or prefer not to use our demo database, you can use the Base\_Start\_Package.
{% endhint %}

### 1. Prepare Installation

In this guide, we assume that you already have Magento installed. To prepare for the installation, please follow these steps:

* **Backup your Magento source files and store database:**

  Creating a backup is crucial before installing the theme, especially if you are working on a live site. Please do not ignore this step.
* **Disable all cache on your server:**

  Make sure to disable any additional cache on your server, such as PHP cache engines (e.g., APC) or any other caching mechanisms.
* **Enable Maintenance mode for your store before uploading the theme source:**     

  Before uploading the theme source files, activate the Maintenance mode for your store. This will ensure a smooth installation process without disrupting your live site.  

By following these steps, you can ensure a safe and seamless installation of the theme on your Magento store.

### 2. Install

<figure><img src="https://3012836149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6vg2ZodXitGeZrLVE7pt%2Fuploads%2FWEBNZrU57oI8eocfSdFw%2Fbase_3.png?alt=media&#x26;token=00ed2a84-e4b2-4a3b-9b3e-8947360376c7" alt=""><figcaption></figcaption></figure>

After downloading the theme package files from ThemeForest, please extract the package. You will find a folder named "Base\_Start\_Package. Follow the steps below to install the Umino theme using this package:

***Step 1:*** Upload all folders from the **"umino\_theme"** package (app, lib, pub) to the root directory (www, public\_html) of your Magento folder. You can achieve this by using FTP software, such as FileZilla. Log in to your hosting account and proceed with the upload.

\ <mark style="color:red;">**Important notice: If you are using version 2.3.7 or lower, you need to replace the variable "$escaper" with "$block." You can do this in two ways:**</mark>

&#x20;      <mark style="color:red;">**\* Option 1: Using a code editor (e.g., Sublime Text, Notepad++, or Visual Studio Code):**</mark>

1. <mark style="color:red;">Open the "umino\_base" folder.</mark>
2. <mark style="color:red;">Press Ctrl+H to open the Find and Replace dialog.</mark>
3. <mark style="color:red;">Replace all occurrences of "$escaper" with "$block".</mark>
4. <mark style="color:red;">Click on "Replace All" to apply the changes.</mark>

<figure><img src="https://3012836149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6vg2ZodXitGeZrLVE7pt%2Fuploads%2FcbJNQqQuVkpC9SJNsexp%2Freplace_1.png?alt=media&#x26;token=120e912b-7fa3-4868-b824-144ff016259c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3012836149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6vg2ZodXitGeZrLVE7pt%2Fuploads%2FU3LNcgRlDOATMtA4z65R%2Freplace_2.png?alt=media&#x26;token=749a5e63-a946-4493-953e-2c1d7a58dd05" alt=""><figcaption></figcaption></figure>

&#x20;     <mark style="color:red;">**\* Option 2: Using the command line:**</mark>

<mark style="color:red;">To proceed with this method, connect to your server via SSH. You can use tools like Putty, Terminus, or mRemoteNG.</mark>

1. <mark style="color:red;">Navigate to the "app" folder using the following command:</mark>

{% hint style="success" %}

1. cd /public\_html/umino\_242/app/
   {% endhint %}

2) <mark style="color:red;">Execute the following command to replace the variable:</mark>

{% hint style="success" %}

```
find . -name "*.phtml" -exec sed -i 's/$escaper/$block/g' {} \;
```

{% endhint %}

3. <mark style="color:red;">This command will find all files with the extension ".phtml" and replace every occurrence of "$escaper" with "$block".</mark>

***Step 2:*** Uploading the Patch (You can skip this step if using Magento version 2.4.6). Depending on your Magento version, follow the instructions below:

For version 2.3.5 or lower:

* Upload and overwrite files in the "patch\_for\_magento\_2.3.5\_and\_below" folder.

For version 2.3.6:

* Upload and overwrite files in the "patch\_for\_magento\_2.3.6" folder.

For version 2.3.7:

* Upload and overwrite files in the "patch\_for\_magento\_2.3.7" folder.

For versions 2.4.0 or 2.4.1:

* Upload and overwrite files in the "patch\_for\_magento\_2.4.0\_and\_2.4.1" folder.

For version 2.4.2:

* Upload and overwrite files in the "patch\_for\_magento\_2.4.2" folder.

For version 2.4.3:

* Upload and overwrite files in the "patch\_for\_magento\_2.4.3" folder.

For version 2.4.4:

* Upload and overwrite files in the "patch\_for\_magento\_2.4.4" folder.

For version 2.4.5:

* Upload and overwrite files in the "patch\_for\_magento\_2.4.5" folder.

For version 2.4.7:

* Upload and overwrite files in the "patch\_for\_magento\_2.4.7" folder.

<mark style="color:red;">Please make sure to apply the appropriate patch that corresponds to your Magento version to ensure compatibility and proper functioning of the theme. Additionally, ensure that you have successfully uploaded all theme folders and files.</mark>

<mark style="color:red;">After completing the theme installation, disable Maintenance Mode for your store to make it accessible to your customers. This will allow them to browse and shop on your website without any interruptions.</mark>

<mark style="color:red;">By following these steps, you can ensure a smooth and seamless experience for both you and your customers using the Umino theme on your Magento store.</mark>

***Step 3:*** Access SSH on your server and navigate to the root directory of your Magento installation. Then, execute the following command lines:

* Note: If you are using an older Magento version (2.4.2 or lower). You need run command composer require lib for old version magento. Magento page builder public in version 2.4.3 Pls run:

{% hint style="success" %} <mark style="color:red;">**composer require phpgt/dom**</mark>

php bin/magento cache:flush

php bin/magento indexer:reindex

php bin/magento setup:upgrade

php bin/magento setup:static-content:deploy -f
{% endhint %}

If you are using Linux, set the appropriate permissions by running this command:

{% hint style="success" %}
sudo chmod 777 -R generated/ var/ pub/
{% endhint %}

For further information on adding CLI commands, please refer to the following link: <https://devdocs.magento.com/guides/v2.4/config-guide/cli/config-cli.html>

By following these steps, you will complete the necessary configuration to ensure the proper functioning of your Magento installation with the Umino theme.

***Step 4:*** Installation completed! The next step is to [**Activation of Purchase Code.**](https://blueskytechcompany.gitbook.io/umino/theme-installation/activation-of-purchase-code)

* Copyright © 2023 [Blueskytechco.com](https://blueskytechco.com/). All Rights Reserved.