Abhineet.in

Blog

  • Experience vs Manager

    Being a manager is a huge responsibility. Even if only one employee is reporting to you, you have the responsibility to mentor them, guide them, support them and be vigilant if they are facing any work-related issue. I have seen many brilliant employees whose talents simply got wasted just because they had an incompetent manager.

    Work experience does not mean that a person is automatically eligible to become a manager. There should be a serious process to identify the right people.

    It is high time that the companies set some serious standards while hiring or promoting someone to the position of a manager. That would be a big differentiating factor between a good company and a GREAT company.

  • Rewrote Sahityapedia Android App in Flutter

    Though I love coding, I am not a professional app developer. As an entrepreneur, I write code as means to an end. It saves cost which is essential for our bootstrapped startup.

    After delaying for quite some time, I finally rewrote the entire Sahityapedia app in Flutter (the latest app framework by Google).

    I wrote the earliest version of this app in Java (on Android Studio). Then Google moved from Java to Kotlin and I migrated the newer versions of this app to Kotlin. And then Google came up with a remarkable technology, Flutter.

    Flutter made things easier, faster and most importantly, I could develop the app using the code editor of my choice, VS Code. Build times are shorter, hot reload is such a cool feature and development workflow feels much more logical.

    So, with great excitement, presenting the latest version of Sahityapedia app. Download now

    www.sahityapedia.com

    #entrepreneur #technology #startup #coding #flutter #sahityapedia #android #google

  • Modify page title tag in WordPress

    To change page title tag in WordPress, use the pre_get_document_title filter.

    Most of the answers on web have mentioned the filter wp_title, but do not use it as wp_title function will be deprecated in future and wp_title hook will not work.

    At present, wp_title filter does not work when modifying the title tag.

  • Prevent Form Resubmission on Page Refresh

    We face a common issue on many websites that whenever a form submits to the same page, and then we refresh the page, the form data is submitted again. Sometimes the browser asks for confirmation, sometimes it does not. It becomes really frustrating if it causes an operation to happen twice.

    To prevent this on our website, all we need to do is add a small Javascript code snippet, and the form resubmission issue will be gone.

    Here is the code-

    <script>
    if ( window.history.replaceState ) {
    window.history.replaceState( null, null, window.location.href );
    }
    </script>

  • Prevent Memory Leak in WordPress

    Recently I faced an issue of memory leak in one of my WordPress projects. I was running a function that was reading post meta and user metadata of thousands of objects. I thought reading data from MySQL is cheap in terms of processing power and memory, but it turned out it was causing my function to crash giving an out-of-memory error.

    I made sure that there was no update being done to either post meta or user meta. It was only reading data through get_user_meta() and get_post_meta() functions. Then what was the reason for the memory leak?

    It turned out that WordPress caches all the results when we read or write to post and user meta. That’s why, on iterating through thousands of posts and users, the result of each was being cached in memory, thus resulting in out-of-memory error.

    To fix this issue, we need to prevent WordPress from caching this data. This can be done through wp_suspend_cache_addition(). This function disables the cache addition for the current page execution. This is how we need to call this function at the start of our script.

    wp_suspend_cache_addition( true );

    And that’s it. Memory usage dropped to less than 6 MB with peak memory usage coming down to mere 13 MB.

    If you are facing a similar issue in WordPress, do remember this function. Also, while writing cron scripts or scripts to bulk update data like import/export scripts, it is better to call this function to ensure there is no out-of-memory issue.

  • Fix Indentation Issue in Visual Studio Code

    In Visual Studio Code, there is a setting to fix tab size to 4 spaces thus making it uniform for all files. It can be set to any value as per the user’s choice. This setting can be modified in settings-> editor.tabSize.

    But whenever VS Code opens a file, it also checks for the default indentation in that file, and tab size can be overridden for that particular file. Many times this results in different tab sizes in different files thus making the code non-uniform.

    Visual Studio Code Tab Size Settings

    To fix this issue, there is another setting to override this per file indentation. It is editor.detectIndentation (Editor: Detect Indentation). Just turn it off and VS Code will start using universal tab size value instead of file-wise tab size assumptions.

  • Correct Way to Manage Title Tags in WordPress

    The title tag is a very important feature of any website. It is displayed at the top of browser tabs and also read by search engines. So, it should be clear to read as well as SEO friendly.

    WordPress is so powerful that it has customization options for almost anything in its structure. The title tag is no exception to this. However, while creating a WordPress theme, what is the best way to generate or modify title tags?

    The earlier method was to include title tag in WordPress head using wp_title() function. But this method was supposed to be deprecated in WordPress version 4.4, but was kept for backward compatibility.

    So, you should not use wp_title() as sooner or later it will be deprecated and removed.

    Starting WordPress version 4.1, the recommended way to add title tag is to declare ‘title-tag’ compatibility in the theme itself. You can do this using the following code snippet.

    add_theme_support( 'title-tag' );

    This code will ensure that title tags are automatically added to the head of all HTML pages (posts, pages, archives, etc.). The format of the title tag is also automatically decided by WordPress. Here is the default structure of the title tags based on the current page-

    Home Page- <Site Name><Separator><Site Tagline>

    Posts- <Post Title><Separator><Site Name>

    Pages- <Page Title><Separator><Site Name>

    Archives- <Archive Title><Separator><Site Name>

    And similarly all other WordPress generated pages will get automatic title tags.

    The values of Site Name and Site Tagline are those which we define in Settings > General.

    You can add theme support directly in the theme if you are creating one. Or, you can create a child theme and add this code in its functions.php file.

    If you are declaring theme support in a plugin, then use the action hook after_setup_theme to ensure that theme support is added once all the plugins and themes are loaded.

    If you are undecided about where to add your code, I have a very good article about where to add custom code in WordPress.

    Now, this structure is perfect for most websites and good for SEO. However, in certain scenarios, we may need to modify the title tag.

    To do that, WordPress has a filter hook document_title_parts using which we can hook into the title tag generating function and modify it dynamically.

    Following is an example snippet of code to do that-

    add_filter( 'document_title_parts', 'modify_title_on_home_page' );
function modify_title_on_home_page( $title_array ) {
    $title_array ['title'] = 'Modified Page Title';
}

    This code modifies the page title on the home page of a WordPress website.

    The document_title_parts filter passes an array containing the title of the current page, page number (in case of paginated pages), site tagline, and site title/name which we can modify and return back.

    And that’s it. You are now ready to utilize the power of WordPress to manage the title tags efficiently.

  • Resolved: Graphics Processor Not Detected in Photoshop

    I installed a new version of Photoshop and, suddenly, it was chaos all around. Photoshop started getting crashed even if there was a small graphic-intensive operation and closed automatically without even giving me a chance to save my work.

    On restarting the application, it was throwing an error message that it disabled enhancements which use the graphics hardware due to some issue with the graphic driver. In Preference>Performance settings, I could see that the Graphics card was not detected and it was turned off, but the software would keep crashing again and again.

    I checked the Windows device manager to update the driver software, and it showed that I already had the latest driver installed.

    On some user forums, I found that it was a known issue in the latest update of Photoshop, and installing a previous release would solve the issue. I uninstalled the current version and installed an earlier release. But it was futile, the problem persisted.

    Then I thought of checking with the graphics card support. I have a decent 2 GB AMD Radeon card which is good enough for moderate Photoshop usage. AMD has a very simple driver update system where their tool will automatically identify the graphics card installed on your system and will update it.

    Once the update was done, it asked for a restart. And, problem solved.

    Photoshop was now able to detect my graphics card and there were no more crashes.

    If you are facing a similar issue, try updating the graphics card drivers from the manufacturer’s website and it should solve the problem.

  • Why some recipients are not getting your emails?

    If you are using email on your custom domain using some email service like Google Workplace or Zoho Mail, you have to do certain configurations to ensure that your emails reach the inboxes of their recipients. Missing emails can be disastrous for a business.

    The most important configurations are SPF and DKIM in your DNS, which authenticate your outgoing emails so that recipient servers do not mark them as phishing or spam emails.

    All email providers provide the settings for SPF and DKIM authentication. You have to add their provided records to your DNS settings.

    Please note that there can be only one SPF record. In case you are configuring your domain to send emails through multiple providers, add their data in the same SPF record.

  • Decode a PHP encoded string url in Javascript

    Sometimes you may face a problem when you have to decode a string with Javascript which was originally url encoded with PHP. This can be an API response or cookie set by PHP setcookie function.

    A simple way to do this is through decodeURIComponent function in Javascript. But it leaves the "+" signs in the string. For that we can use replace function to replace all the "+" signs with space. Remember, simply using replace function sign will only replace the first occurrence in the string. To replace all the occurrences, use the regex version with g flag.

    Here is the code for your reference-

    var decodedString = decodeURIComponent( encodedString ).replace( /+/g, ' ' );

    Here encodedString is the url encoded string received from PHP.

    Its that simple!

    If you have any other method, do share in comments.

    Happy coding!

  • How to change Post Type in WordPress

    While working with custom post types in WordPress, many times we come across the need to change the post type of a particular post.

    It can be done either directly through code or using a plugin.

    Without Plugin

    This can be done using WordPress functions- wp_update_post or set_post_type.

    wp_update_post can be used when updating multiple fields of a post.

    In case, only post type has to be changed, then set_post_type is sufficient.

    Just use set_post_type along with the post id and you are done.

    If you are unsure about where to add this code, take a look at Where to add custom code in WordPress.

    Using Plugin

    If you occasionally want to switch posts and do not want to fiddle with the code, there is a good plugin for this which easily performs this task- Post Type Switcher.

    Simply install and activate a plugin. It will add the option to change post types in the admin menu.

    A good thing about this plugin is that it allows to change the post type of multiple posts in bulk by utilizing the "bulk edit" feature in WordPress.

    So, now you know how to change post type with or without a plugin. Which one do you like better? Do let me know in comments section.

  • How to view and modify WordPress rewrite rules

    If you encounter a sudden unexpected delay in page load which was previously working fine, a good place to check is the rewrite rules.

    In my case, it seems there was some issue in the currently generated rules which was causing this delay.

    A simple visit to Settings->Permalink automatically flushed and regenerated all the rewrite rules and it resolved the issue for me. The page is again loading as fast as it did earlier.

    However, if you want to check the current rewrite rules, there is a simple code to check that.

    Add the below code to your plugin or theme.

    // Filter to display rewrite rules on permalink settings page when debugging 
add_filter( 'rewrite_rules_array', 'show_all_the_rewrite_rules' );
function show_all_the_rewrite_rules( $rules ) {
    echo nl2br( var_export( $rules, true ) );
    die;
}

    Now this hook is only called on Permalink Settings page. So, visit that page and you will be able to see all the current rewrite rules of your website.

    You can also remove rules if they are not required, based on regex as shown in the following code.

    // Filter hook to remove unwanted rewrite rules, will only run when **setting->permalink** page is opened
function remove_rewrite_rules( $rules ) {
    foreach ( $rules as $rule => $rewrite ) {
        if ( preg_match( '/(feed|rss|atom|embed|attachment|trackback|year|date|search/)/', $rule ) ) {
            unset( $rules[$rule] );
        }
    }

    return $rules;
}

    You can define any pattern in the preg_match function to remove the unwanted rewrite rules.

    Hope this helps.

  • How to replace Paragraph Break with Line Break in LibreOffice Writer

    In Microsoft Word, this is very easy. You just need to open “Find and Replace”, enable Wildcards and replace ^13 (paragraph break) with ^l (line break).

    But this is a little different in LibreOffice Writer. But you do not require any macro for this. Just follow this process.

    • First of all, type a line break by pressing “Shift” + “Enter”
    • Now copy this line break
    • Now open “Find and Replace” (You can use the shortcut “ctrl” + “H” to open “Find and Replace” dialogue box)
    • Click on checkbox for Regular Expressions
    • Type “$” in the find box to search for paragraph break
    • Click on “Find All”. This will cause all the paragraph breaks in the document to get selected
    • Close the “Find and Replace” box without removing the selection
    • Press “ctrl” + “V” and it will paste line break in place of all the paragraph breaks

    That’s it.

  • Whitelist all sub-sites for wp_safe_redirect in WordPress Multisite

    In WordPress, there are two functions for redirecting a page- wp_redirect and wp_safe_redirect.

    wp_redirect can be used to redirect to any url.

    wp_safe_redirect can only redirect to current site. In case any external url is provided, the page is redirected to wp-admin.

    For security, it is recommended to use wp_safe_redirect function for any redirects. This works fine for single WordPress installation. But in case of subdomain based WordPress multisite, this fails because each sub-domain is an individual domain for wp_safe_redirect.

    What if we want to use wp_safe_redirect to redirect our pages only within network and not outside?

    For this purpose, WordPress has a filter to add additional domains to the wp_safe_redirect whitelist. You can add any domain or sub-domain, internal or external, through this method.

    In this article, we will focus on how to whitelist all the sub-domains of a network.

    Just add the following code to your custom plugin or child theme’s function.php file.

    // Filter to add all subdomains to wp_safe_redirect whitelist
add_filter( 'allowed_redirect_hosts', 'whitelist_all_subdomains' );

function whitelist_all_subdomains( $hosts ) {
    $sites = get_sites();
    $domains = array();

    foreach ( $sites as $site ) {
        $domains[] = $site->domain;
    }

    return array_merge( $hosts, $domains );
}

    This code gets all the sites through get_sites function and iterates all the sites to create an array of all domains/sub-domains of sub-sites. It then adds that to the whitelist.

    If you try now, you will see that page redirects across sub-sites of a network using "wp_safe_redirect" are flawless.

  • Make Javascript sequential with “async” and “await”

    Most of the older programming languages are sequential in nature. That means, when the code runs, it is executed line by line. If there is a function call, the next line is executed only when the function has been executed and returned control. This is blocking in nature and helps programmers easily predict the output of their code.

    But when we move to async languages like Javascript, code is non-blocking in nature. That means, execution does not wait for any function to return response. This is good for performance, but creates a problem when the next line of code requires output from the function call made in previous line.

    To solve this problem, Javascript provides Promises. Promises allow us to write a callback function to process the response of the called function. But their syntax requires to write another function to handle the response. Also, if there are multiple functions, it may lead to callback hell.

    The syntax of a function returning a promise is:

    function add(a, b) {
    return new Promise(function(resolve, reject) {
        resolve(a+b);
    });
}

    And this is how we handle the returned Promise:

    add(2,3).then(function(response) {
    console.log(response);
}

    This becomes cumbersome if there are a lot of function calls nested inside one another. To simplify this code, there are two keywords in Javascript to write promises in a very simple way- async and await.

    async

    async can be placed before a function definition. It means that the function will always return a promise. If the returned value is not a promise, it will wrap it in a promise and return.

    async function demoFunction() {
    return 1;
}

    await

    await can be placed before any line of code to ensure that Javascript hold the execution till that line is executed. If there is a function call in that line, Javascript is wait till the function returns a response.

    async function demoFunction() {
    let sum = await add(a, b);
    console.log(sum);
}

    In the above example, we are calling a function called add and saving its value in a variable called sum. The await ensures that the next line is executed only after we get the value returned from the function add. If we remove the await keyword from this, console.log may print an empty variable.

    So, even if the called function is returning a promise, there is no need of defining any callback function. Just simply store its return value in a variable and process it in the next line of code. This is pretty much like we do stuff in C or PHP.

    Note: await can only be used inside an async function.

    This is such a simple syntax that can easily make Javascript code sequential whenever needed.

    To read the detailed description of these keywords, you can refer to the following articles:

  • Javascript: Loop over querySelectorAll without error

    Javascript: Loop over querySelectorAll without error

    In Javascript, there are a lot of instances when you want to find multiple elements on a page to apply a common operation to all of them.

    Suppose you want to hide elements of a particular class present on your web page. To do this, first get an array of all such elements using querySelectorAll and then loop through that array items to change the display property of all such elements.

    But there is an issue. querySelectorAll also returns additional data, a static NodeList. If you iterate through all the items, you will hit the static NodeList which will give error.

    So, what is the solution for this?

    First, find the number of elements found matching the given selector using length property. Then use a for loop and iterate upto length number of items.

    This will be more clear through following code example.

    // Let's assume that we are looking for all elements with class "demo-item"
elements = document.querySelectorAll( '.demo-item' );
var i = 0;
for ( i = 0; i &lt; elements.length; i++ ) {
elements[i].style.display = "none";
}

    Hope this helps.

  • Where to add custom code in WordPress

    Where to add custom code in WordPress

    WordPress offers a lot of features right out of the box. If you want to create a blog, you can start using WordPress without the need to add any additional plugin.

    When you want some additional functionality not provided by the core WordPress, you can find and install a plugin from the WordPress plugin repository.

    WordPress plugins repository contains thousands of plugins and in most cases, you will find the plugin for your required functionality.

    But there are cases when you do not find the perfect plugin. There may be plugins, but they are so bloated that you do not want to use them. Or, you need a very small functionality and installing a full-blown plugin with a lot of unnecessary features may seem illogical.

    In such cases, it is always better to write your own code for adding that functionality. But where to add that code?

    Where to add the code

    If you want to modify a core WordPress feature, you may be tempted to edit the WordPress core files directly. But this is not a sustainable practice as whenever WordPress will be updated, your changes would be overwritten.

    If you want to change the functionality of your current theme, you edit the functions.php file inside your theme. But again, if the theme is updated, you will lose the changes.

    In short, you must NOT edit any core WordPress files, themes or plugins. Rather, you need to add code to override or extend that functionality based on the APIs provided by WordPress.

    There are two recommended ways to add custom code to WordPress-

    • Create a child theme of your current theme and add code to its functions.php file
    • Create a custom plugin and add it to your website

    Theme vs Plugin

    WordPress has very nicely separated the design and development functionality. Themes are meant for the front-end design of the website and plugins are meant for adding functionality to the website.

    It is important to strictly follow this separation logic to ensure a clean and easy to maintain code.

    WordPress provides the functionality to add a child theme to override the current theme’s files. You can override templates and add code to functions.php file.

    But you must not add any code to a theme that is not related to front-end design. All such code should reside in plugin only. Plugins are the right place for all your non-design functionality.

    I have seen a lot of WordPress tutorials on various popular websites that encourage users to add custom code to their child theme’s functions.php file. But this approach is wrong.

    If you add your custom code to WordPress child theme, you violate the code separation logic, thus messing up your website for the future.

    Creating a small single-page plugin and adding it to WordPress is easier compared to adding a child theme. Plugins are easy to manage and you can easily create a directory structure for your code if you are creating a complex plugin with multiple functions.

    Is it safe to add custom code to my WordPress blog

    Security is a very important concern when writing code. If you are not a good programmer and somehow you leave any vulnerability in your code, it can be a huge issue for your website. To make sure that this does not happen, you should follow proper coding standards and best practices.

    If it is a small function, it is very easy to ensure that it is free from vulnerabilities. But in case you are planning for a complex plugin, make sure that you properly review your code and test the code for all possible scenarios.

    If you are a decent programmer, you can write code which is secure and clean. Though security is important, fear of security must not discourage you from creating your own plugin. It actually enhances your skill and gradually you become good at it.

    Just carefully write your code, review it properly and test it thoroughly. You can refer to security best practices for coding, you can review the code of plugins offering similar functionality or if needed, you can take an online course to improve your programming skills.

    It is not reinventing the wheel

    A lot of people tell you not to write your plugins if someone has already created a plugin with your required functionality as you will be reinventing the wheel.

    This logic does not work efficiently in the coding world. Yes, creating an entire CMS like WordPress to host your blog is surely reinventing the wheel. But, adding some code to add functionality may not be the same.

    If you are writing code to avoid installing a badly coded or bloated plugin to your WordPress blog, it is a good practice.

    If you write a good plugin which works nicely for your WordPress blog and you think that it will be beneficial for a lot of WordPress users, you may decide to release the code publicly by submitting it to WordPress plugin repository.

    This way, you can contribute back to the WordPress community and at the same time, it will help you improve your coding skills.

    Conclusion

    WordPress may be full of a lot of functionality, there may still be many things where it may fall short of your expectations. Though a lot of plugins are available in the WordPress plugin repository, you may not find the plugin which suits your requirements. This calls for writing your custom code and add it to your WordPress blog.

    Writing custom code for WordPress may be easy, but you should carefully add your code at the correct place to keep it clean and easily maintainable.

    The best way to add your custom code to WordPress is to create a plugin and add it to your WordPress blog.

    Do make sure that you follow proper coding standards and best practices. Also, do proper code review and testing to ensure that your code is safe.

  • How to create a WordPress plugin

    How to create a WordPress plugin

    In this post, you will learn how to create a simple WordPress plugin without any complex setup or need of FTP/SSH to your hosting server.

    Before we begin with this post, let us understand a few things.

    I will try to keep the code as simple as possible. My objective in this post is to help you understand how easy it is to create WordPress plugins.

    You do not need any FTP or SSH access to your hosting server. All you need is access to your WordPress dashboard with an administrator account with the ability to upload new plugins.

    No tools setup is required for creating this plugin. You can write the code in a basic text editor like Notepad which is already included in your Windows computer.

    However, I would recommend using a slightly better text editor like Notepad++ which also offers syntax highlighting, but it is completely optional.

    No FTP tool is required to upload the code. If you have one and know how to upload, you can try that, but it is not needed at all.

    WordPress is amazing

    WordPress offers amazing features right out of the box. If you want to create a blog using WordPress, it is as easy as installing software on your Windows computer. There is no coding required.

    WordPress makes it so simple. It is a complete blogging system with everything in place to write your next awesome blog.

    Let us take a look at some of the basic features of WordPress supported out of the box-

    • Create posts, classify them with categories and tags
    • Upload and manage images, videos, etc. using its built-in media library
    • Define the URL structure of your choice using permalink settings
    • A simple yet fully functional comment system with dedicated comment management dashboard
    • Thousands of free themes to change your blog’s appearance with just a single click
    • Thousands of free plugins to add any additional functionality

    There are many more features that I cannot list here, but you got the idea. WordPress is a complete powerhouse for bloggers helping them focus on their content rather than worrying about managing the technicalities.

    Why plugins

    No matter how comprehensive a particular software is, there may be innumerable cases where some additional functionality is required. The same is the case with WordPress. Though most of the blogging features are included in the core, there may be situations where additional functionality is needed. That’s where WordPress plugins come into the picture.

    For example, if you need to add your copyright text in the page footer, you can find and install a plugin that offers that functionality. The plugin may also add settings page to your WordPress dashboard to allow you to configure the plugin settings.

    But, what if the plugin you found includes 10 more features which you do not need. Though it will work for you, it will add bloated code to your blog by adding unnecessary additional features which are of no use to you.

    In such a scenario, a good option can be to create your plugin. Yes, it is very easy and a much better option if you want to add a small functionality to your WordPress blog.

    Before we dive into creating the plugin, there is one thing you need to know- WordPress Hooks.

    What are WordPress Hooks

    As the name suggests, hooks are small checkpoints within the WordPress code where you can inject your functionality. You can just write a function and connect to the hook and your function will be called every time the hook is executed by WordPress.

    For example, WordPress defines a hook called wp_footer‘ which is called by WordPress when it renders the page footer. You can connect your code with this hook to print your copyright notice in the footer.

    Hooks are of two types-

    1. Action hooks
    2. Filter hooks

    Action Hooks

    Action hooks are mainly for executing some code and print it. For example, I already told you about wp_footer. It is called during the creation of page footer during page load and you can print anything you want to the footer by hooking your function to this action hook.

    You can also use an action hook to execute some code that has to be executed on each page load. For example, wp_init is an action hook that is executed when WordPress loads the required data before rendering the page. You can hook into this to execute anything you need before the page is sent back to the user.

    All you have to do is create a function and tell WordPress to call it whenever wp_footer is executed.

    Filter Hooks

    Filter hooks are useful if you want to manipulate or modify data within the WordPress functions. For example, the_content is a filter hook that filters the post content to be printed in the post or page. You can hook into this filter, and it will pass the content string to your function. You can modify this value and return the new value which will be taken by WordPress to print the final content on the page.

    This understanding is enough to create your first plugin. I will discuss the code in the next section.

    The Plugin

    We have got a good understanding of WordPress hooks. Now, using this knowledge, we will create a small plugin. To keep things simple, our plugin will simply add some text to the footer of our WordPress blog.

    A WordPress plugin can be a single file or it can be a directory with a bunch of files. To keep things simple, our current plugin will be of a single page, with all the code in the same file.

    First of all, we need to select a unique name for our plugin file which must not be a clash with the name of any other plugin in the WordPress repository. To ensure that there is no clash, we will prefix our plugin name with our blog’s name. A good file name can be webrosis-footer-printer.php.

    You can use the prefix of your name, blog or company. The file name is completely your choice.

    Create a file with this name and open it in a text editor.

    Every WordPress plugin index file (in case of a directory) or main file (in case of a single-page plugin) must contain header comment with specific header fields as defined by WordPress.

    WordPress uses the details provided in this header comment to display plugin’s information in the installed plugins list in the WordPress dashboard.

    In the header comment, it is mandatory to define "Plugin name". Everything else is completely optional. As an example, below is a header comment which I have created for our plugin. You can replace the values with your own.

    <?php
/**
 * Plugin Name:       Webrosis Footer Printer
 * Description:       Prints custom content in footer
 * Version:           1.0
 * Author:            Abhineet Mittal
 */

    There can be more header fields, but for now, this seems enough for our plugin.

    The Code

    We want to print our custom content to page footer. So, we will hook into ‘wp_footer’ action hook.

    We will first write a function to print our custom content and then hook it to wp_footer action through `add_action’ function.

    // Function to print copyright notice in footer
function webrosis_print_content_in_footer() {
    echo 'The content on this website is copyright protected. Do not copy. All Rights Reserved.';
}
// Now hook this function to wp_footer action
add_action( 'wp_footer', 'webrosis_print_content_in_footer' );

    Save the file.

    That’s it. This is the only code you need to write. When added to your WordPress blog, this plugin will print the given content in the page footer.

    Here is the complete code-

    <?php
/**
 * Plugin Name:       Webrosis Footer Printer
 * Description:       Prints custom content in footer
 * Version:           1.0
 * Author:            Abhineet Mittal
 */

// Function to print copyright notice in footer
function webrosis_print_content_in_footer() {
    echo 'The content on this website is copyright protected. Do not copy. All Rights Reserved.';
}
// Now hook this function to wp_footer action
add_action( 'wp_footer', 'webrosis_print_content_in_footer' );

    This plugin will not add any configuration settings to your WordPress dashboard as we have not coded that. However, once you start writing plugins, you can learn about the WordPress Settings API to add your custom settings page in the WordPress admin dashboard.

    Installation

    You have created your first plugin. Now its time to add it to your WordPress blog. Use the following steps-

    1. Zip this plugin file
    2. Go to your WordPress blog dashboard and click on "Plugins > Add New"
    3. Upload the zipped file of your plugin
    4. Now activate the plugin by clicking on "Activate"

    If you have done everything till now exactly as I told you, the plugin will be successfully activated.

    Now go to any post or page on your blog frontend and you will find that your content has been added to the footer.

    Congratulations! You have successfully created your first WordPress plugin.

    So, you saw how amazingly simple it is to create a WordPress plugin. If you want to add small functionalities, it is better to write your small functions and add them to your plugin.

    Your plugin can only be installed by uploading the zipped file. It will not be available in the WordPress plugins repository until you submit it.

    I have not covered uploading the plugin in the WordPress repository as it is a separate process and requires many more steps. At this level, you must first practice writing plugins. Once you start writing useful plugins, you may consider submitting them to the WordPress plugins repository to be used by the community.

    Way forward

    In this post, you have learned how to create a WordPress plugin. But our example was a very simple one as it was just to explain to you how a plugin works.

    To create more meaningful plugins, you can read about other filters and API functions provided by WordPress. A good starting point is WordPress Documentation.

    Here are a few simple ideas which you can implement in your plugin-

    • Add Google Analytics code by hooking into wp_head action
    • Add beautiful author box below the content of your posts by hooking into the_content filter
    • Modify the title of your pages by hooking into ‘wp_title’ filter

    You can think of many more ideas as per your blogging requirements.

    Conclusion

    We created a very simple WordPress plugin that printed some custom content in our blog’s footer. It showed, how easy it is to add small functionalities to your WordPress blog by adding simple code in the form of plugins.

    Thanks for reading. I hope you found this post useful.

  • How to use PHP built-in web server

    If you are a PHP developer, chances are you have already set up a web server (WAMP or LAMP software) on your desktop. It gives you the ability to test your PHP code locally rather than testing it on a remote server.

    But what if you are working on a machine where you do not have a web server installed? Or, you may not have sufficient permissions to install the webserver on a desktop.

    Luckily, PHP provides a way out of this situation. PHP has a built-in web server that can be run directly without the need for any setup or installation.

    Some assumptions

    For this tutorial, I am making the following assumptions-

    1. My first assumption is that you are on a Windows machine, but you can implement this on any system by downloading appropriate PHP files.
    2. My second assumption is that your website is in the following folder in your desktop- F:projectsmy-php-website. You may change it to the appropriate folder of your website.
    3. My third assumption is that there is a valid index.php file in your website root folder

    How to run the PHP built-in web server

    1. Download PHP for Windows.
    2. Unzip it and save it on your desktop- F:projectsmy-php-websitephp
    3. Now press, type cmd, and press enter, to open your command prompt
    4. Now navigate to your website’s root folder using this command- cd f:projectsmy-php-website
    5. Now execute this command to run the webserver pathtophpphp.exe -S localhost:4000

    It will immediately fire up the PHP web server. You can type localhost:4000 in your web browser and it will run your index file.

    That’s great! Such a convenience without the hassles of setting up an entire web server. You can run any number of instances of this server. It is single-threaded and has its limitations, but it is sufficient for running the PHP website test code.

    You can also make changes to the PHP configuration by editing the php.ini file. You can also add/remove PHP modules.

    URL Rewriting and routing

    There is one important feature missing in PHP built-in server- URL Rewriting. Suppose you have URL rewriting for pretty permalinks enabled in your website and you want to test that functionality locally.

    Apache webserver provides the capability to add the .htaccess file to implement URL rewriting. In the PHP server, you can implement similar functionality by setting up a router.php file.

    Add a router.php file to your website root and add the following code-

    // router.php

// Get the url path and trim leading slash
$url_path = trim( $_SERVER[ 'REQUEST_URI' ], '/' );

// If url_path is empty, it is root, so call index.html
if ( ! $url_path ) {
    include( 'index.html' );
    return;
}

// If url_path has no dot, it is a post permalink, so add .html extension
if( ! preg_match( '/[.]/', $url_path ) ) {
    include( $url_path . '.html' );
    return;
}

    This code takes the path from URL and rewrites requests for HTML files to call them without .html extension. You can implement any functionality you want.

    Do remember, adding router.php will give the responsibility of adding the entire response on your shoulders. So, if you are including static files like style files with .css extension, you will have to handle that as well.

    // Get the url path and trim leading slash
$url_path = trim( $_SERVER[ 'REQUEST_URI' ], '/' );

// In case of css files, add the appropriate header
if( preg_match( '/[.css]/', $url_path ) ) {
    header("Content-type: text/css");
    include( $url_path );
    // You can do the same for other file types as well
}

    Now, go to the command line. If your PHP server is already running, press ctrl+c to stop it. Run this command-
    pathtophp.exe -S localhost:4000 router.php
    Now, again open the localhost:4000 in your web browser. It will now execute your router.php file and which, in turn, will include the required PHP files.

    This technique will save you time if you quickly need to check your code.

    Limitations of PHP built-in server

    PHP built-in server is a useful tool for developers. However, it has its limitations.

    1. It is single-threaded. That means if a request is blocked, the server will stall the execution.
    2. Once you start adding more logic to your router.php file, it will soon become cluttered. It is very difficult to scale it for large projects.
    3. There is no SQL support. You can either use SQLite, which is a good option or install a separate SQL server.

    Conclusion

    Despite its limitations, PHP built-in web server is a useful tool for web developers. It helps in saving time in many situations and makes code testing, an easy task.

  • Enable Gzip compression in WordPress with htaccess

    With the advancement of web technologies, you have ready-to-use frameworks for any functionality you want to add to your website or WordPress blog. Just include these framework files to your website and add its features through their easy to use API.

    For example, if you want readymade styling for your website, you can use CSS frameworks like Bootstrap or Foundation. Similarly, a lot of Javascript libraries are available to add advanced features to your website, without needing you to code complex functions.

    Using these frameworks, developers can create fully functional websites in a short time. All they have to do is to include the framework files to their HTML page, then use its functions to implement the desired functionality.

    Similarly, these days, people are more oriented towards visual data. It has become necessary to add a lot of images and videos to their content to attract and engage users. Many times, they also include custom-developed CSS and JS files in addition to all the other resources.

    Though this makes the websites better in terms of functionality and aesthetics, adding all these files makes the webpage very heavy and negatively affects the website performance.

    In a lot of WordPress themes, each page load requires dozens of additional scripting and styling files in addition to the already included media files.

    When a user opens such a website in their browser, the browser immediately starts downloading all the resources from the requested web page and render it for the user. It may include stylesheets, script files, images, videos, etc.

    Each request to such files increases the page load time as the user has to wait for the resources to get downloaded. If you have multiple files with huge sizes, it adversely affects your site performance.

    Now, if the user is on a high-speed internet connection, this may not be a problem at all. But, you cannot assume that all your users are accessing your website through the best internet connections.

    As a simple WordPress user, you may have downloaded or purchased an excellent theme for your blog. You may like the functionality of that theme, but the extra file requests are slowing down your website.

    You may not know how to optimize the theme through coding. But, you can optimize your blog for better performance through some simple tweaks at the server level.

    Two things can be done to improve your WordPress blog performance. They are browser caching and Gzip compression. You can do this at the server level by simply adding some configuration code to .htaccess file in your website root folder.

    Browser Caching ensures that your static resources are cached by the user browser to avoid multiple requests of the same file on different pages. The user will save on bandwidth, and the site load speed will improve.

    I have already written a post about Browser Caching where I have provided the required configuration.

    Let’s take a look at Gzip compression in this post. Gzip compression speeds up your WordPress website by compressing the resources at the server level using simple .htaccess configuration in Apache server.

    Gzip compresses the files to reduce payload. It even compresses the minified CSS and JS files to smaller sizes.

    Just add the following code to your .htaccess file.

    # BEGIN Compressing

# Compress HTML, CSS, JavaScript, Text, XML and fonts
AddOutputFilterByType DEFLATE application/javascript
AddOutputFilterByType DEFLATE application/rss+xml
AddOutputFilterByType DEFLATE application/vnd.ms-fontobject
AddOutputFilterByType DEFLATE application/x-font
AddOutputFilterByType DEFLATE application/x-font-opentype
AddOutputFilterByType DEFLATE application/x-font-otf
AddOutputFilterByType DEFLATE application/x-font-truetype
AddOutputFilterByType DEFLATE application/x-font-ttf
AddOutputFilterByType DEFLATE application/x-javascript
AddOutputFilterByType DEFLATE application/xhtml+xml
AddOutputFilterByType DEFLATE application/xml
AddOutputFilterByType DEFLATE font/opentype
AddOutputFilterByType DEFLATE font/otf
AddOutputFilterByType DEFLATE font/ttf
AddOutputFilterByType DEFLATE image/svg+xml
AddOutputFilterByType DEFLATE image/x-icon
AddOutputFilterByType DEFLATE text/css
AddOutputFilterByType DEFLATE text/html
AddOutputFilterByType DEFLATE text/javascript
AddOutputFilterByType DEFLATE text/plain
AddOutputFilterByType DEFLATE text/xml

# END Compressing

    This code ensures that Apache will compress all the files using Gzip before sending them to the user.

    Once you implement this code, check your page speed using Google Page Speed Insights tool. You will notice the improvement in your page speed score.

    Even if you are not facing website speed issues, you must implement Browser Caching and Gzip Compression on your website. It is recommended by Google & widely supported by most browsers.