forked from chaddro/EasyPopulate-4.0
/
INSTALL.txt
executable file
·88 lines (57 loc) · 4.37 KB
/
INSTALL.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
REQUIREMENTS:
Zencart 1.38/1.39 or 1.5 except 1.5.2
PHP 4.3.2 or above.
PRIOR TO INSTALLATION:
I highly recommend that you install Dr. Bytes "Backup MYSQL Plugin" before installing
and using EasyPopulate 4.0 Beta (EP4). It has recently been updated to work with Zencart 1.5
and can be downloaded from here:
http://www.zen-cart.com/index.php?main_page=product_contrib_info&products_id=81
Also note that EasyPopulate 4.0 Beta will install and run independently of all other
versions of easypopulate. Names 1.2.5.4 (and flavors) and EP Advance 3.0.3.
INSTALLATION (Upgrade from any prior version of EP4) is suggested as follows:
1) From the configuration->Easy Populate menu, document all of the settings so that they may be re-entered after installation.
2) From the tools->Easy Populate 4 menu, uninstall EP4 through the link in the upper right corner.
3) Load the files from the attached zip file into their standard location as is done through the below EP4 installation instruction.
4) Refresh the Tools->EP4 window.
5) Select the install option in the middle of the Tools->EP4 window.
6) Return to the configuration->Easy Populate window and re-enter the settings captured in step 1. Also review the new options made available to support use of the rewriter.
INSTALLATION:
1. Change the name of the "admin" directory to match your Zencart installation.
2. Upload all files in the "admin" directory to your site maintaining directory structure.
No core files are changed.
a) If you are using zencart 1.3.8/1.3.9, you need to also upload the additional
files in the "zencart 1.3 extra files" folder.
b) If you are using zencart 1.5, you need to also upload the additional
files in the "zencart 1.5 extra files" folder.
3. Login to your store's admin. Under Tools you will see a new entry "Easy Populate 4".
(If you do not see this entry, you did not upload your files correctly.)
4. Click on Tools -> Easy Populate 4. You will have 1 (possibly 2) warnings at the top of the page:
Warning Easy Populate "Uploads Folder" missing!
Your uploads folder is missing. Your configuration indicates that your uploads folder is named EASYPOPULATE_4_CONFIG_TEMP_DIR/, and is located in .../public_html/.
Warning Easy Populate Configuration Missing. Please install your configuration by clicking here
Click the "here" link to install EP4's configuration files.
5. Now go to Configuration -> Easy Populate 4 and edit the Uploads Directory. The default directory is "temp/"
This assumes you have a directory "temp" in the root of your website. I highly recommend that you
move your temp directory into your admin, or change the name to something that is obscure for security reasons.
Note: If you are using Zencart 1.5 and want to move your Uploads directory into this folder, you will need to
customize an .htaccess file to add allowed file types of .csv/.CSV and .txt/.TXT.
6. Now click on Tools -> Easy Populate 4. The warning messages should be gone. Note that your temp/
directory will need correct permissions. EP4 will give you a warning if it cannot write to the temp/ directory
that you set. Common permissions are "777" or "755". Contact your hosting provider if you are having problems
setting permissions to writable, but you can usually do this through your site's CPANEL, or via a FTP program.
UN-INSTALLATION:
To un-install EP4, go to Tools -> Easy Populate 4 and click the Un-Install EP4 link on the right-hand side of your screen.
This will remove the Configuration keys for EP4. You will then need to delete EP4's files from your server.
POST INSTALLATION NOTES:
EP4 will display the current version and Beta date. This will help you keep track of your version and updates as they are posted to github.
On the right-hand side of your screen you will see some additional information:
- An un-install link that will remove EP4's configuration keys.
- Your currently set Temporary Directory
- Supported Mods
- Installed Languages
Supported Mods: These are where you'll find additional fields that have been added to the products table.
Note that Product Unit of Measure (UOM) and Product UPC Code are two of my own custom mods.
Github will continue to be updated with improvements as they come. Once EP4 has passed "beta" it will be submitted
to the Zencart team for consideration. Your feedback and testing is greatly appreciated!
Thank you,
Chadd and mc12345678