PHP Melody uses CSRF protection by default. If you experience the following error message in your back-end, please consider disabling CSRF:
Invalid token or session expired. Please load this page from the menu and try again.
Here’s how to do it:
As is tradition, the process consists of 3 easy steps:
Log into your Google Cloud Platform account. Create your new project or select an existing one.
Once your new project is available, search “YouTube Data API V3” and enable the data source. You can also create the project here if you’re a rebel and skipped step 1.
The end goal is to enable the YouTube data source for your project, which you did. Half-way there.
Generate and save your API keys as illustrated below. But first, locate the YouTube DATA API.
Here you can choose to restrict the API key to your own domain. If unsure about this, leave the default options until you get the website operational. Otherwise, make sure to use the correct details about your domain and the rules you set. This part can’t be ignored and is the #1 source for problems.
When set incorrectly, there can be no communication between your domain and the YouTube API since the restrictions/rules prevent it. Don’t worry, you’ll get an error message about it.
Just copy/pasta your shiny new API key in PHP Melody’s ‘Settings’ page (you know where) and you’re good to go.
Have fun and be mindful of API usage and Google’s terms of service.
You’re here because you need help with an update problem or it’s your first time updating PHP Melody. Either way, the following guide should answer all your questions.
This document is divided into the following sections:
New features, improvements and bug fixes for PHP Melody come in the form of an update package. Applying the update packages is 100% optional but we do recommend you try to keep your PHP Melody website(s) up to date.
Updates bring changes to both the PHP Melody file structure as well as its MySQL database. That is why it’s crucial to always use the official update packages to update your video site. We’ll show you how to correctly update your PHP Melody later in this guide.
In case you don’t have the time or desire to keep your PHP Melody up-to-date, we’re here to help. Our team can ensure your PHP Melody installation is always up-to-date by applying the new update packages. Please contact our support team to arrange for this service.
Log into your website’s admin area and in the footer of all your pages you can find the PHP Melody version (as shown below):
Your customer account will give you access to both the full purchased product(s) as well as all the available update packages for each product.
The full product packages should only be used for new installations (never for updates).
To download the required update package(s), log into your Customer Account and browse to the ‘Download Updates‘ page.
It’s important to mention that you cannot and should never update your PHP Melody website(s) by applying the packages you can get from the ‘Download Products‘ page (i.e. the full product package).
To update your PHP Melody site correctly, always use the packages from the ‘Download Updates‘ page (i.e. the update package).
While it may sound obvious to you, we mention this because some customers have attempted to update their websites with the full package from the ‘Download Products‘ page only to find out that it ruins the site. That is because only the update packages include MySQL updating files.
Let’s begin by assuming you’re currently running PHP Melody v2.3 and need to update to the latest version which is v2.6.
You should end up with 5 zip packages saved locally. Begin the update process by unzipping the first update package (v2.3.1) and read the included Update Guide 2.3.1.pdf file. Note: each includes a update guide PDF.
Always read the Update Guide because each update includes important update instructions.
The update guides will advise you to only upload the update package after creating a backup of your current installation. Always backup your files and MySQL database before updating. Any problems can easily be solved by restoring the backup.
Once you’ve uploaded all the files and folders, log into your PHP Melody back-end site and follow the on-screen instructions to finish the update process. Logging into your administration area after uploading the update package is a mandatory step. It’s easy to overlook this step if you apply multiple updates.
Finally, if no update steps were skipped, your site will be updated to v2.3.1. You can now continue applying the next update package (v2.4). Repeat until you reach the latest version.
In summary, the key to a successful update is to: backup your existing files and MySQL database, read and follow the update instructions from the PDF, upload all the files and folders from the update package and update the MySQL database.
Case 1: Uploading the wrong files without altering the MySQL database.
PHP Melody updates have safety-checks to ensure that you cannot accidentally apply the wrong update package. However, this covers the MySQL changes and it won’t prevent you from uploading the wrong files via FTP.
Let’s say you’re using PHP Melody v2.3 and, by mistake, uploaded the latest full package; v2.6. In this case, just restore the PHP Melody v2.3 files from the full package and overwrite the v2.6 files. In case you no longer have the v2.3 full package, please contact our support team and we will be happy to send you the required files.
After uploading the correct files, you can resume the update process by applying an update package.
Case 2: Applying both the wrong files and modifying or corrupting the MySQL database.
Without a backup there is little chance of fixing this problem by yourself because the damage is too extensive.
You shouldn’t worry because our team provides data recovery and general recovery services. We’ve successfully fixed numerous sites and recovered data in as fast as 24 hours for our customers.
We can help you fix corrupted MySQL tables, recover data from old PHP Melody installations and update your site in the process. Please get in touch with us if you’re looking to recover a crashed or wrongly updated site.
I’ve updated my site exactly as you instructed but I cannot see the new features in the front-end.
In this case one of two things might have happened. Firstly, ensure the new feature(s) are not disabled by default (because some are). If your site uses a custom theme, make sure the theme is also up-to-date. To update your theme, simply download the latest theme version from your Customer Account and upload it to your site.
With each update, we’re also updating our available themes and plugins. Be sure to update your custom theme as well. Unlike PHP Melody, you can skip to the latest PHP Melody theme as long as the PHP Melody version and the theme version are the same/match.
I’m trying to change the settings form the back-end but the settings page doesn’t save them.
Such behavior indicates the MySQL database is not up to date. This is caused by either skipping updates or neglecting the last update step; updating the database. Since there is no general solution for this, contact our team. We can update your database for you (paid service).
My admin footer indicates I’m using the latest version but I don’t see the features or the latest theme.
There is a (slight) possibility that the version indicated is not true. This happens if someone manually updates the version number by hand or if the wrong update package was applied. If you’re unsure about this, contact our support team right away.
You may want to manually change the PHP Melody version so that you can apply the correct update package. To manually change the version number, use phpMyAdmin to manually edit the ‘pm_config’ table. Look for the ‘version’ entry and change the version as needed.
Warning: under normal circumstances you should never find yourself doing this. If you are, something has gone terribly wrong and perhaps the best idea would be to get in touch with our support team and determine what needs to be done next.
Never update the version number by hand unless you really know what you’re doing. We cannot take any responsibility for the problems this might cause.
You may want to do this for several reasons all concerning the security of your website. Let’s see how you can rename the ‘admin‘ folder without breaking PHP Melody.
Open /config.php and find this line:
Replace the ‘admin‘ value with your new folder name (e.g. admin2015). Edit only the underlined bit. Make sure there are no empty spaces between the single quotes.
Save and upload /config.php to your installation.
Rename your ‘admin‘ folder to match the new folder name (i.e. admin2015).
That’s it. Job done!