A number of people have been having some difficulty installing my extension manually, and so they should, they are not designed to be installed manually but rather through Magento Connect. This will be a short and sweet guide to installing my Magento extension through FTP or SSH. This could probably be applied to installing any extension manually, so if you just need help knowing where to put extension files, read on.
Those that follow this blog (all 3 of you) will know that I’ve been unable to upload my latest release to Magento Connect and have been offering it for download through my site directly in the meantime. Quite a number of you have been able to install it without a hitch, but the confusing nature of the extension layout is blocking some people from being able to use the extension. Let’s hope this guide helps.
Preparation
The first thing to do is download the extension, you can get it over at my blog post about the new email logging features. For the purposes of this little how to guide, let’s assume you put the file in your home directory.
Installing a Magento Extension by SSH
On a Unix or Mac computer, start your Terminal of choice, on windows I think you’ll have to use WinSCP (someone want to correct me on that?) and navigate to your home directory, where you diligently saved the extension release file.
Run this command to upload the file to your server home directory (in this example I’m using version 1.1.1, adjust accordingly):
|
<pre class="bash" style="box-sizing: border-box; overflow: visible !important; font-family: monospace; font-size: 14px !important; background: transparent !important; margin: 0px !important; padding: 0px 4px !important; max-width: 100%; border: none !important; width: auto !important; float: none !important; clear: none !important; line-height: 16px !important; white-space: pre !important; box-shadow: rgba(0, 0, 0, 0) 0px 0px 0px !important; border-radius: 0px !important;">scp Aschroder_SMTPPro-1.1.1.tgz username@server:</pre>
|
Once the file is on the server then jump on there yourself to install the extension:
|
<pre class="bash" style="box-sizing: border-box; overflow: visible !important; font-family: monospace; font-size: 14px !important; background: transparent !important; margin: 0px !important; padding: 0px 4px !important; max-width: 100%; border: none !important; width: auto !important; float: none !important; clear: none !important; line-height: 16px !important; white-space: pre !important; box-shadow: rgba(0, 0, 0, 0) 0px 0px 0px !important; border-radius: 0px !important;">ssh username@server</pre>
|
Now unarchive the extension, I suggest doing this in a temporary directory, to keep everything tidy
|
<pre class="bash" style="box-sizing: border-box; overflow: visible !important; font-family: monospace; font-size: 14px !important; background: transparent !important; margin: 0px !important; padding: 0px 4px !important; max-width: 100%; border: none !important; width: auto !important; float: none !important; clear: none !important; line-height: 16px !important; white-space: pre !important; box-shadow: rgba(0, 0, 0, 0) 0px 0px 0px !important; border-radius: 0px !important;">mkdir ext-temp
mv Aschroder_SMTPPro-1.1.1.tgz ext-temp
cd ext-temp
tar xzf Aschroder_SMTPPro-1.1.1.tgz</pre>
|
Now is a good time to check your handy work:
|
<pre class="bash" style="box-sizing: border-box; overflow: visible !important; font-family: monospace; font-size: 14px !important; background: transparent !important; margin: 0px !important; padding: 0px 4px !important; max-width: 100%; border: none !important; width: auto !important; float: none !important; clear: none !important; line-height: 16px !important; white-space: pre !important; box-shadow: rgba(0, 0, 0, 0) 0px 0px 0px !important; border-radius: 0px !important;">aschroder:ext-temp ashley$ ls
Aschroder_SMTPPro-1.1.1 package.xml
Aschroder_SMTPPro-1.1.1.tgz
aschroder:ext-temp ashley$ ls Aschroder_SMTPPro-1.1.1
Aschroder adminhtml modules</pre>
|
Looks good eh? Ok now to put those folders where they are supposed to be. For this part I’m going to assume you have a public_html directory in your home directory, and that is the root of your Magento installation. If that is crazy talk to you, an SSH install may not be the best option.
|
<pre class="bash" style="box-sizing: border-box; overflow: visible !important; font-family: monospace; font-size: 14px !important; background: transparent !important; margin: 0px !important; padding: 0px 4px !important; max-width: 100%; border: none !important; width: auto !important; float: none !important; clear: none !important; line-height: 16px !important; white-space: pre !important; box-shadow: rgba(0, 0, 0, 0) 0px 0px 0px !important; border-radius: 0px !important;">mv Aschroder_SMTPPro-1.1.1/Aschroder/ ~/public_html/app/code/community/
mv Aschroder_SMTPPro-1.1.1/modules/Aschroder_SMTPPro.xml ~/public_html/app/etc/modules/
This could debate-ably be put in base, not default as of Magento 1.4 - I'm open to opinion on that.
PS: Lines that start with a hash symbol are comments, you just read them
mv Aschroder_SMTPPro-1.1.1/adminhtml/default/default/template/smtppro ~/public_html/app/design/adminhtml/default/default/template/</pre>
|
So that puts all the files where they need to be, now you just have to clear your Magento cache and you’re done. You made it.
If you are OCD on files hanging around your server, you’ll want to get rid of the temporary files once everything is working:
|
<pre class="bash" style="box-sizing: border-box; overflow: visible !important; font-family: monospace; font-size: 14px !important; background: transparent !important; margin: 0px !important; padding: 0px 4px !important; max-width: 100%; border: none !important; width: auto !important; float: none !important; clear: none !important; line-height: 16px !important; white-space: pre !important; box-shadow: rgba(0, 0, 0, 0) 0px 0px 0px !important; border-radius: 0px !important;">cd ..
rm -r ext-temp</pre>
|
Installing a Magento Extension by FTP
The FTP route is much more graphical, so I’ll try to draw this as a picture using Mac finder, hopefully that will make it clear. You’ll want to do this using your favorite FTP client.
Extract the package, possibly in a temporary directory:
<figure id="attachment_786" class="wp-caption aligncenter" style="box-sizing: border-box; display: block; margin: 0px auto 1em; clear: both; max-width: 100%; color: rgb(109, 109, 109); font-family: "Source Sans Pro", HelveticaNeue-Light, "Helvetica Neue Light", "Helvetica Neue", Helvetica, Arial, "Lucida Grande", sans-serif; font-size: medium; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration-style: initial; text-decoration-color: initial; width: 497px;">
The extracted extension files
<figcaption class="wp-caption-text" style="box-sizing: border-box; display: block; text-align: left; font-style: italic; border-bottom: 2px solid rgba(0, 0, 0, 0.05); padding: 1em 0px;">The extracted extension files</figcaption>
</figure>
These are the files you’ll see inside the Aschroder_SMTPPro-1.1.1 directory:
<figure id="attachment_785" class="wp-caption aligncenter" style="box-sizing: border-box; display: block; margin: 0px auto 1em; clear: both; max-width: 100%; color: rgb(109, 109, 109); font-family: "Source Sans Pro", HelveticaNeue-Light, "Helvetica Neue Light", "Helvetica Neue", Helvetica, Arial, "Lucida Grande", sans-serif; font-size: medium; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration-style: initial; text-decoration-color: initial; width: 442px;">
The files inside the actual package
<figcaption class="wp-caption-text" style="box-sizing: border-box; display: block; text-align: left; font-style: italic; border-bottom: 2px solid rgba(0, 0, 0, 0.05); padding: 1em 0px;">The files inside the actual package</figcaption>
</figure>
Your target Magento install should look like this:
<figure id="attachment_784" class="wp-caption aligncenter" style="box-sizing: border-box; display: block; margin: 0px auto 1em; clear: both; max-width: 100%; color: rgb(109, 109, 109); font-family: "Source Sans Pro", HelveticaNeue-Light, "Helvetica Neue Light", "Helvetica Neue", Helvetica, Arial, "Lucida Grande", sans-serif; font-size: medium; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration-style: initial; text-decoration-color: initial; width: 369px;">
The base of the Magento install that you'll be installing into
<figcaption class="wp-caption-text" style="box-sizing: border-box; display: block; text-align: left; font-style: italic; border-bottom: 2px solid rgba(0, 0, 0, 0.05); padding: 1em 0px;">The base of the Magento install that you'll be installing into</figcaption>
</figure>
Put the Aschroder directory into the app/code/community:
<figure id="attachment_783" class="wp-caption aligncenter" style="box-sizing: border-box; display: block; margin: 0px auto 1em; clear: both; max-width: 100%; color: rgb(109, 109, 109); font-family: "Source Sans Pro", HelveticaNeue-Light, "Helvetica Neue Light", "Helvetica Neue", Helvetica, Arial, "Lucida Grande", sans-serif; font-size: medium; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration-style: initial; text-decoration-color: initial; width: 319px;">
Put the Aschroder directory into the community directory.
<figcaption class="wp-caption-text" style="box-sizing: border-box; display: block; text-align: left; font-style: italic; border-bottom: 2px solid rgba(0, 0, 0, 0.05); padding: 1em 0px;">Put the Aschroder directory into the community directory.</figcaption>
</figure>
Put the modules/Aschroder_SMTPPro.xml file into app/etc/modules/:
<figure id="attachment_781" class="wp-caption aligncenter" style="box-sizing: border-box; display: block; margin: 0px auto 1em; clear: both; max-width: 100%; color: rgb(109, 109, 109); font-family: "Source Sans Pro", HelveticaNeue-Light, "Helvetica Neue Light", "Helvetica Neue", Helvetica, Arial, "Lucida Grande", sans-serif; font-size: medium; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration-style: initial; text-decoration-color: initial; width: 272px;">
Put the module file into the app/etc/modules directory.
<figcaption class="wp-caption-text" style="box-sizing: border-box; display: block; text-align: left; font-style: italic; border-bottom: 2px solid rgba(0, 0, 0, 0.05); padding: 1em 0px;">Put the module file into the app/etc/modules directory.</figcaption>
</figure>
Put the smtppro template folder into the default adminhtml template folder:
<figure id="attachment_780" class="wp-caption aligncenter" style="box-sizing: border-box; display: block; margin: 0px auto 1em; clear: both; max-width: 100%; color: rgb(109, 109, 109); font-family: "Source Sans Pro", HelveticaNeue-Light, "Helvetica Neue Light", "Helvetica Neue", Helvetica, Arial, "Lucida Grande", sans-serif; font-size: medium; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration-style: initial; text-decoration-color: initial; width: 342px;">
Put the smtppro templates into the default adminhtml templates directory.
<figcaption class="wp-caption-text" style="box-sizing: border-box; display: block; text-align: left; font-style: italic; border-bottom: 2px solid rgba(0, 0, 0, 0.05); padding: 1em 0px;">Put the smtppro templates into the default adminhtml templates directory.</figcaption>
</figure>
And then you should be done. Refresh your Magento cache and you’ll be complete. Happy emailing. Let me know how you get on.
网友评论