Close

November 2, 2015

Magento Supee-6788 Troubleshooting Tips

The latest round for Patches from Magento (Supee-6788) have seemed to have caused a lot of confusion. While important, the patches fail to take into consideration that a few stock files may have been changed (.htaccess) or removed (.htaccess.sample). The patch also errors on cryptic messages and seemingly provide very little to troubleshoot with.

We have applied it to a few community edition Magento versions as well as an enterprise install and have had a mixed bag of results. We have documented a set of common tips that have helped us trouble shoot most of the issues with the new patch.

1.) If you do not have a development server..just stop now. Have someone setup a development server in the cloud for you to test. Do NOT apply this patch to your production server without any testing.

2.) Download a copy of the Magento files for your exact version that you are running. You will need to extract the .htaccess and .htacess.sample files (and possibly others, if you had modified core files at some point. TSK TSK).

3.) BACK UP your current .htaccess file.
Extract fresh copies from the Magento downloads (#2) (.htaccess and htaccess.sample) file from a free download of your exact Magento version. Copy those over and run the patch. The patch should at LEAST clear that file now.

Diff this new file with your old htacess file, and merge the new fixes. Roll out the new .htaccess file.

4.) Any issues with any other failures. Make sure you have applied every single other patch successfully. We have seen that not applying older patches would cause the new 6788 to fail each time. After patching the older patches, the 6788 worked like a charm, 100% of the time.

Update 11/3/2015
5.) Password Reset screen is blank. Apparently Magento also changed the name of the block that directs a user to the actual reset form.

Find your “customer.xml” file and search for anything with “customer_account_resetpassword”. You’ll need to completely replace that block like the following.

<!-- 11315 patch 6788 reset password changed -->
	<customer_account_changeforgotten translate="label">
        <label>Reset a Password</label>
        <remove name="right"/>
        <remove name="left"/>
 
        <reference name="head">
            <action method="setTitle" translate="title" module="customer">
                <title>Reset a Password</title>
            </action>
        </reference>
        <reference name="root">
            <action method="setTemplate">
                <template>page/1column.phtml</template>
            </action>
            <action method="setHeaderTitle" translate="title" module="customer">
                <title>Reset a Password</title>
            </action>
        </reference>
        <reference name="content">
            <block type="customer/account_changeforgotten" name="changeForgottenPassword" template="customer/form/resetforgottenpassword.phtml"/>
        </reference>
    </customer_account_changeforgotten>

We are always here to help you with expert Magento Consulting Services. Contact Us today if you need any assistance securing or applying patches to your Magento site.