<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Ahmad Ajmi on Medium]]></title>
        <description><![CDATA[Stories by Ahmad Ajmi on Medium]]></description>
        <link>https://medium.com/@ahmadajmi?source=rss-df7b08d297e7------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*I_PkOclrHWBD_SgsNRaLvA.jpeg</url>
            <title>Stories by Ahmad Ajmi on Medium</title>
            <link>https://medium.com/@ahmadajmi?source=rss-df7b08d297e7------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Thu, 19 Nov 2026 06:48:42 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@ahmadajmi/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[How to Create an Authors Page in Your Ghost Theme]]></title>
            <link>https://medium.com/aspirethemes/how-to-create-an-authors-page-in-your-ghost-theme-256ee898e5a2?source=rss-df7b08d297e7------2</link>
            <guid isPermaLink="false">https://medium.com/p/256ee898e5a2</guid>
            <category><![CDATA[ghost-theme]]></category>
            <category><![CDATA[blogging]]></category>
            <category><![CDATA[web-development]]></category>
            <category><![CDATA[themes]]></category>
            <category><![CDATA[ghost-blog]]></category>
            <dc:creator><![CDATA[Ahmad Ajmi]]></dc:creator>
            <pubDate>Wed, 09 May 2018 08:54:23 GMT</pubDate>
            <atom:updated>2020-01-12T15:29:54.705Z</atom:updated>
            <content:encoded><![CDATA[<p>Adding a page to list all the blog authors in your Ghost theme will give your readers the opportunity to discover and browse your authors easily.</p><p>In this post, I will share with you how to add a custom authors page to your Ghost theme. I will use the default Casper theme as an example, but all the steps and codes will apply to any theme with a little customization as required.</p><h3>Create the Authors Page Theme File</h3><p>In your theme directory, create a new file and name it custom-authors.hbs and then copy the following code inside it. You may need to restart your Ghost server for the new page to take effect.</p><pre>{{!&lt; default}}<br><br>&lt;header class=&quot;site-header&quot;&gt;<br>  &lt;div class=&quot;outer site-nav-main&quot;&gt;<br>    &lt;div class=&quot;inner&quot;&gt;<br>      {{&gt; &quot;site-nav&quot;}}<br>    &lt;/div&gt;<br>  &lt;/div&gt;<br>&lt;/header&gt;<br><br>{{#post}}<br><br>&lt;main id=&quot;site-main&quot; class=&quot;site-main outer&quot; role=&quot;main&quot;&gt;<br>  &lt;div class=&quot;inner&quot;&gt;<br>    &lt;header class=&quot;post-full-header&quot;&gt;<br>      &lt;h1 class=&quot;post-full-title&quot;&gt;{{title}}&lt;/h1&gt;<br>    &lt;/header&gt;<br><br>    {{#get &#39;authors&#39; limit=&#39;all&#39; include=&#39;count.posts&#39; order=&#39;count.posts desc&#39;}}<br>      &lt;div class=&quot;post-feed&quot;&gt;<br>        {{#foreach authors}}<br>          &lt;article class=&quot;post-card {{#unless profile_image}} no-image{{/unless}}&quot;&gt;<br>            {{#if profile_image}}<br>              &lt;a class=&quot;post-card-image-link&quot; href=&quot;&quot;&gt;<br>                &lt;div class=&quot;post-card-image&quot; style=&quot;background-image: url(https://medium.com/%7B%7Bprofile_image%7D%7D)&quot;&gt;&lt;/div&gt;<br>              &lt;/a&gt;<br>            {{/if}}<br>            &lt;div class=&quot;post-card-content&quot;&gt;<br>              &lt;a class=&quot;post-card-content-link&quot; href=&quot;{% raw %}{{url}}&quot;&gt;<br>                &lt;header class=&quot;post-card-header&quot;&gt;<br>                  &lt;h2 class=&quot;post-card-title&quot;&gt;{{name}}&lt;/h2&gt;<br>                &lt;/header&gt;<br>                &lt;section class=&quot;post-card-excerpt&quot;&gt;<br>                  &lt;p&gt;{{bio}}&lt;/p&gt;<br>                &lt;/section&gt;<br>              &lt;/a&gt;<br>            &lt;/div&gt;<br>          &lt;/article&gt;<br>        {{/foreach}}<br>      &lt;/div&gt;<br>    {{/get}}<br>  &lt;/div&gt;<br>&lt;/main&gt;<br><br>{{/post}}</pre><p>In this code, the <a href="https://themes.ghost.org/docs/get">get</a> helper used to get the blog users. The include attribute used to get the posts count. The order attribute used to order the users list based on the posts attached to them.</p><p>Next, the <a href="https://themes.ghost.org/docs/foreach">foreach</a> helper used to loop through each author and render the list with the author profile image, name, URL and bio.</p><h3>Create the Authors Static Page</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kthtCOIdiONPGEN_0vKaeg.png" /><figcaption>Authors Page</figcaption></figure><ul><li>Create a new page and call it <strong>Authors</strong> for example.</li><li>From Page settings, select the Authors template from the Template dropdown.</li><li>Publish the page.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*H7XW4fht2BQ3jwFB.png" /></figure><p>This is an initial example of what you can do to the authors page. You can take the code further and show the author social media accounts, location, cover image, and posts count. As an example, you can create something like what I have done with the <a href="https://themeforest.net/item/nubia-responsive-multipurpose-ghost-theme/21076246"><strong>Nubia</strong></a> theme. You can also add the tag page link to the blog <a href="https://aspirethemes.com/docs/nubia-ghost/#navigation">navigation</a>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*M9sPUwlPYvRFi73QE_0cWQ.png" /><figcaption>Nubia Ghost Theme Authors Page</figcaption></figure><p>I would recommend checking the <a href="https://themes.ghost.org/docs/about">official Ghost documentation</a> including the <a href="https://themes.ghost.org/docs/author-context">author-context</a> for more information about the list of available attributes.</p><h4>If you are looking for fast, elegant and premium Ghost themes, make sure to visit <a href="https://aspirethemes.com/?utm_source=medium&amp;utm_medium=articles">Aspire Themes</a> 👌</h4><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=256ee898e5a2" width="1" height="1" alt=""><hr><p><a href="https://medium.com/aspirethemes/how-to-create-an-authors-page-in-your-ghost-theme-256ee898e5a2">How to Create an Authors Page in Your Ghost Theme</a> was originally published in <a href="https://medium.com/aspirethemes">Aspire Themes</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[How to Create A Tags List Page in Your Ghost Theme]]></title>
            <link>https://medium.com/aspirethemes/how-to-create-a-tags-list-page-in-your-ghost-theme-7a151413f5b0?source=rss-df7b08d297e7------2</link>
            <guid isPermaLink="false">https://medium.com/p/7a151413f5b0</guid>
            <category><![CDATA[blogging]]></category>
            <category><![CDATA[themes]]></category>
            <category><![CDATA[blogging-tips]]></category>
            <category><![CDATA[ghost-blog]]></category>
            <dc:creator><![CDATA[Ahmad Ajmi]]></dc:creator>
            <pubDate>Mon, 19 Mar 2018 14:16:41 GMT</pubDate>
            <atom:updated>2020-08-16T08:51:15.420Z</atom:updated>
            <content:encoded><![CDATA[<p>Adding a page to list all the tags in your <a href="https://ghost.org/?lmref=CnlkjQ">Ghost</a> theme will give your readers the opportunity to discover and browse your content.</p><p>In this post, I will share with you how to add a custom tags page to your <a href="https://ghost.org/?lmref=CnlkjQ">Ghost</a> theme. I will use the default Casper theme as an example, but all the steps and codes will apply to any theme with a little customization as required.</p><h3>Create the Tags Page Theme File</h3><p>In your theme directory, create a new file and name it custom-tags.hbs and then copy the following code inside it.</p><pre>{{!&lt; default}}<br><br>&lt;header class=&quot;site-header&quot;&gt;<br>  &lt;div class=&quot;outer site-nav-main&quot;&gt;<br>    &lt;div class=&quot;inner&quot;&gt;<br>      {{&gt; &quot;site-nav&quot;}}<br>    &lt;/div&gt;<br>  &lt;/div&gt;<br>&lt;/header&gt;<br><br>{{#post}}<br><br>&lt;main id=&quot;site-main&quot; class=&quot;site-main outer&quot; role=&quot;main&quot;&gt;<br>  &lt;div class=&quot;inner&quot;&gt;<br>    &lt;header class=&quot;post-full-header&quot;&gt;<br>      &lt;h1 class=&quot;post-full-title&quot;&gt;{{title}}&lt;/h1&gt;<br>    &lt;/header&gt;<br>    {{#get &#39;tags&#39; limit=&#39;all&#39; include=&#39;count.posts&#39; order=&#39;count.posts desc&#39;}}<br>    {{#foreach tags}}<br>        &lt;a href=&#39;{{ url }}&#39;&gt;<br>        &lt;h2&gt;{{ name }} &lt;small&gt;({{ count.posts }})&lt;/small&gt;&lt;/h2&gt;<br>        &lt;/a&gt;<br>    {{/foreach}}<br>    {{/get}}<br>  &lt;/div&gt;<br>&lt;/main&gt;<br><br>{{/post}}</pre><p>In this code, the <a href="https://themes.ghost.org/docs/get">get</a> helper used to get the blog tags. The include attribute used to include the posts count. The order attribute used to order the tags based on the number of posts attached to them.</p><p>Next, the <a href="https://themes.ghost.org/docs/foreach">foreach</a> helper used to loop through each tag and render the list with the tag URL, title, and the posts count.</p><p>At this stage, you may need to do a server restart. This will help the Template dropdown to show up in the next step.</p><h3>Create the Tags Static Page</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Iey3OSgz7epXLjHxgPH5tA.png" /><figcaption>Tags Page</figcaption></figure><ul><li>Create a new page and call it <strong>Tags</strong> for example.</li><li>From Page settings, select the Tags template from the Template dropdown.</li><li>Publish the page.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bkgCykhzhza1DA4NTp9hyQ.png" /></figure><p>This is an initial example of what you can do to the tags page. You can take the code further and show the tag image with a custom design. As an example, you can create something like what I have done with the <a href="https://aspirethemes.com/themes/nubia/"><strong>Nubia</strong></a> and <a href="https://aspirethemes.com/themes/sinai/"><strong>Sinai</strong></a> themes. You can also add the tag page link to the blog <a href="https://aspirethemes.com/docs/nubia-ghost/#navigation">navigation</a>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*4K-nJ7CctffzrBjT.png" /><figcaption>Nubia Theme Tags Page</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*3IAVcXKctfHgWmC6sWNfPA.png" /><figcaption>Sinai Theme Tags Page</figcaption></figure><p>I would recommend checking the <a href="https://docs.ghost.org/">official Ghost documentation</a> including the <a href="https://themes.ghost.org/docs/tags">tags</a> for more information about the list of available attributes.</p><h4>If you are looking for fast, elegant and premium Ghost themes, make sure to visit <a href="https://aspirethemes.com/?utm_source=medium&amp;utm_medium=articles">Aspire Themes</a> 👌</h4><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7a151413f5b0" width="1" height="1" alt=""><hr><p><a href="https://medium.com/aspirethemes/how-to-create-a-tags-list-page-in-your-ghost-theme-7a151413f5b0">How to Create A Tags List Page in Your Ghost Theme</a> was originally published in <a href="https://medium.com/aspirethemes">Aspire Themes</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[How I Create Faster Themes]]></title>
            <link>https://medium.com/aspirethemes/how-i-create-faster-themes-7b3e90295f87?source=rss-df7b08d297e7------2</link>
            <guid isPermaLink="false">https://medium.com/p/7b3e90295f87</guid>
            <category><![CDATA[performance]]></category>
            <category><![CDATA[ghost-blog]]></category>
            <category><![CDATA[website-optimization]]></category>
            <category><![CDATA[front-end-development]]></category>
            <category><![CDATA[web-development]]></category>
            <dc:creator><![CDATA[Ahmad Ajmi]]></dc:creator>
            <pubDate>Thu, 07 Sep 2017 18:59:32 GMT</pubDate>
            <atom:updated>2020-02-02T10:44:00.965Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/560/1*jvazIPcUrsqv2UMTG-kf1Q.jpeg" /></figure><p>Performance is one of the most important things I care about in my work creating themes at <a href="https://aspirethemes.com/?utm_source=medium&amp;utm_medium=articles">Aspire Themes</a>. Recently, I received an inquiry email about how I achieve such a great performance record, that record could be 100% with Google Page Speed from some themes I did, for example, <a href="https://developers.google.com/speed/pagespeed/insights/?url=https%3A%2F%2Faspire-jekyll.aspirethemes.com%2F&amp;tab=desktop">Aspire</a> for Jekyll, <a href="https://developers.google.com/speed/pagespeed/insights/?url=https%3A%2F%2Faspirethemes.com%2F">Aspire Themes</a> website, <a href="https://developers.google.com/speed/pagespeed/insights/?url=http%3A%2F%2Fdahab.aspirethemes.com%2F&amp;tab=desktop">Dahab</a> for <a href="https://ghost.org/?lmref=CnlkjQ">Ghost</a>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/738/1*0maSbH9xawvJYd4I1FtFjg.png" /><figcaption>Email Message</figcaption></figure><p>There are some things I do to help me achieve a good score which I replied to the email and I found that it would be great to share them with the community.</p><ol><li>I don’t ever use CSS frameworks (Bootstrap, …) they are very bad for performance and for coding a custom work, too much code bloat which in return make pages load slower.</li><li>Instead, I craft the Theme’s code from scratch using Sass, ITCSS, this in return produces high quality faster and small custom code.</li><li>I use automation tools like Gulp to minify the final CSS and JS into only one file, and in the case of Ghost and Jekyll, the CSS is inlined in the header which would increase the performance may be 10 to 20%.</li><li>For the themes demos, I use the available tools everyone can use, for example, DigitalOcean for WP and Ghost and I use <a href="https://www.netlify.com/">Netlify</a> for Jekyll and all with the default hosting settings. Aspire Themes is also built with Jekyll and hosted on Netlify and the score is 99 and it is open source.</li><li>One more important thing is that I optimize the demo images and I expect everyone should do this, but uploading big images would definitely make things worse even if the theme is 100% and Google would complain about images optimization as they play a huge role to the general score and considered outside the theme job scope. So I do my best from the theme side and then the site owner would do his best too.</li></ol><p>So, I optimize the code very very much, optimize the images, host in a good place.</p><p>The case for WordPress, for example, is that it’s loading some code that makes the scoreless, but if you checked the Bold for Ghost, you will get <a href="https://developers.google.com/speed/pagespeed/insights/?url=http%3A%2F%2Fbold.aspirethemes.com%2F">91/97 score</a>. So every time you install a new plugin to WP, performance will decrease due to the more resources loaded which are outside the theme scope.</p><p>So, with the optimized themes and the more you optimize your images, you can easily achieve the same score.</p><h4><em>Did you enjoy this post? Why not give it some </em>❤️ or a share? Also, if you are looking for a new WordPress, Ghost, or Jekyll theme, check out <a href="https://aspirethemes.com/">Aspire Themes</a> 👌</h4><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7b3e90295f87" width="1" height="1" alt=""><hr><p><a href="https://medium.com/aspirethemes/how-i-create-faster-themes-7b3e90295f87">How I Create Faster Themes</a> was originally published in <a href="https://medium.com/aspirethemes">Aspire Themes</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[How to Add a Contact Form to Your Ghost Blog]]></title>
            <link>https://medium.com/aspirethemes/add-contact-form-to-ghost-blog-b9bff75ea070?source=rss-df7b08d297e7------2</link>
            <guid isPermaLink="false">https://medium.com/p/b9bff75ea070</guid>
            <category><![CDATA[web-development]]></category>
            <category><![CDATA[themes]]></category>
            <category><![CDATA[ghost-blog]]></category>
            <category><![CDATA[blog]]></category>
            <dc:creator><![CDATA[Ahmad Ajmi]]></dc:creator>
            <pubDate>Fri, 11 Aug 2017 08:55:32 GMT</pubDate>
            <atom:updated>2020-01-12T15:21:34.362Z</atom:updated>
            <content:encoded><![CDATA[<p>Recently, one of my customers at <a href="https://aspirethemes.com/?utm_source=medium&amp;utm_medium=articles">Aspire Themes</a> asked me if there is a way to add a contact form to his new Ghost blog as there is no built-in contact form shipped with Ghost and there is no support for plugins like WordPress for example.</p><p>I did some research and found some interesting tools to add a contact form quickly to Ghost. I found <a href="https://formspree.io/">Formspree</a> to be a great and quick option to try and it is also free to use.</p><p>In this post, I will go through adding a contact form, from creating the contact page, add the form, and then add the page to the site navigation.</p><h4>Create the Contact Page</h4><p>From the Ghost admin Pages section, click the <strong>New Page</strong> button, then add the page title, for example, <em>Contact</em>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*l-QLuhxax9gRw7ni2zTYhw.png" /><figcaption>Creating Contact Page</figcaption></figure><p>Once this is done, we can now move to the next step.</p><h4>Create the Contact Form</h4><p>The following code is a simple example, which contains the name, email, and text area fields, which the sender can fill and send the message.</p><pre>&lt;form action=&quot;<a href="https://formspree.io/your@email.com">https://formspree.io/your@email.com</a>&quot; method=&quot;POST&quot;&gt;<br>  &lt;input type=&quot;text&quot; name=&quot;name&quot;&gt;<br>  &lt;input type=&quot;email&quot; name=&quot;_replyto&quot;&gt;<br>  &lt;textarea name=&#39;message&#39;&gt;  &lt;/textarea&gt;<br>  &lt;input type=&quot;submit&quot; value=&quot;Send&quot;&gt;<br>&lt;/form&gt;</pre><p>Once you are in the page editor, click on the circle icon and then choose the HTML block.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Iy0lOncUt2gvotDsDUbbmg.png" /><figcaption>Add HTML Block</figcaption></figure><p>Copy the code to the block area, then you can <strong>publish</strong> the page.</p><p>The required thing to do is to replace your@email.com email with your own email address, copy the code to the page content, then you can <strong>publish</strong> the page.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*BIDjOHdRPqOlooy6IF60Jw.png" /></figure><p>Now, go to the contact page and submit the form once. This is a required step and you will get an email asking you to confirm your email address.</p><p>Once you confirmed your email address, the form will be ready for work and you will get an email once anyone sends you an email like the following one.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/690/1*WJquxsrJsZ9UfiIM8bYNNw.png" /><figcaption>Message Example</figcaption></figure><h4>Add the Page to the Blog Navigation</h4><p>The last step is to add the contact page to the blog navigation. Go to Design &gt; Navigation and a new navigation field with babel and the page slug, then click the <strong>SAVE</strong> button.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/959/1*O9Mk84iBAC0-dyjZ3v1Mdg.png" /></figure><p>You can then style your form based on your design and add more fields or customize the form based on your requirements, so make sure to visit the <a href="https://formspree.io/">Formspree</a> website for more information.</p><h4><strong>If you are looking for fast, elegant and premium Ghost themes, make sure to visit </strong><a href="https://aspirethemes.com/?utm_source=medium&amp;utm_medium=articles"><strong>Aspire Themes</strong></a><strong> 👌</strong></h4><p>Thank you!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b9bff75ea070" width="1" height="1" alt=""><hr><p><a href="https://medium.com/aspirethemes/add-contact-form-to-ghost-blog-b9bff75ea070">How to Add a Contact Form to Your Ghost Blog</a> was originally published in <a href="https://medium.com/aspirethemes">Aspire Themes</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[On Web Accessibility]]></title>
            <link>https://medium.com/@ahmadajmi/on-web-accessibility-57d4f4ca0ae3?source=rss-df7b08d297e7------2</link>
            <guid isPermaLink="false">https://medium.com/p/57d4f4ca0ae3</guid>
            <category><![CDATA[web-design]]></category>
            <category><![CDATA[udacity]]></category>
            <category><![CDATA[course]]></category>
            <category><![CDATA[accessibility]]></category>
            <dc:creator><![CDATA[Ahmad Ajmi]]></dc:creator>
            <pubDate>Mon, 12 Jun 2017 16:30:38 GMT</pubDate>
            <atom:updated>2017-06-12T16:34:35.176Z</atom:updated>
            <content:encoded><![CDATA[<p>Today, I just finished and I would recommend this <a href="https://www.udacity.com/course/web-accessibility--ud891">Web Accessibility course from Google by Udacity</a>.</p><p>Accessibility is something I wasn’t taking seriously before and was just reading some bits here and there without understanding and seeing the big picture if using it.</p><p>The important thing is that there is a wide range of people who might have some disabilities and by ignoring them you will make their life harder and they will end up leaving, but the web should be available to everyone.</p><p>Think about how someone who is blind using the VoiceOver, and a simple case, someone who is only able to use the keyboard to navigate your website or app.</p><p>I encourage you to stop using the mouse for a while and just use your keyboard to navigate different websites or use the ChromeVox or VoiceOver as a screen reader.</p><p>The problem comes with no awareness about it, no budget, or not learning about it at the start of learning about web development as a single topic, somehow we ignore it and jump directly into writing HTML without thinking about this wide range of people who might use the end product.</p><p>The course helped to connect the dots and the important thing is to think about the end user while writing code or <em>*Developing with Empathy*</em> as the course said :)</p><p><em>This post was also published on my </em><a href="https://ahmadajmi.com/journal/web-accessibility/"><em>Journal</em></a><em>.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=57d4f4ca0ae3" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Create Your Own Public Slack Chat Community with Slackin]]></title>
            <link>https://medium.com/aspirethemes/create-your-own-public-slack-chat-community-with-slackin-1825c1d3efb2?source=rss-df7b08d297e7------2</link>
            <guid isPermaLink="false">https://medium.com/p/1825c1d3efb2</guid>
            <category><![CDATA[community-engagement]]></category>
            <category><![CDATA[startup]]></category>
            <category><![CDATA[community]]></category>
            <category><![CDATA[slack]]></category>
            <dc:creator><![CDATA[Ahmad Ajmi]]></dc:creator>
            <pubDate>Thu, 16 Mar 2017 10:05:30 GMT</pubDate>
            <atom:updated>2018-02-03T18:23:30.676Z</atom:updated>
            <content:encoded><![CDATA[<p>I was looking to create a Slack channel for <a href="https://aspirethemes.com/?utm_source=medium&amp;utm_medium=articles">Aspire Themes</a> where I and my customers can discuss, share, and get fast support with Slack. The one thing I worried about is how anyone can get an invitation and join the channel easily.</p><p>I found <a href="https://github.com/rauchg/slackin">Slackin</a> to be a great solution, it creates a public landing page for users to fill their email to receive a Slack invitation.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*wiWgGHec1FGblL7s44QL6g.png" /><figcaption><a href="https://github.com/rauchg/slackin">Slackin</a></figcaption></figure><h4>Prepare Slack</h4><ul><li>Create a new team on <a href="https://slack.com/">Slack</a>.</li><li>Create a new <a href="https://get.slack.help/hc/en-us/articles/215770388-Create-and-regenerate-API-tokens">API token</a> to the team.</li></ul><h4>Deployment</h4><ul><li>Install the <a href="https://zeit.co/download#command-line">Now</a> command line interface for with NPM.</li></ul><pre>npm install -g now</pre><p>Next, from the command line, use the following <a href="https://github.com/rauchg/slackin#usage">command</a> to deploy <a href="https://github.com/rauchg/slackin">Slackin</a> to <a href="https://zeit.co/">ZEIT</a>, using the API token and the team name you early created.</p><pre>now -e SLACK_API_TOKEN=&quot;&lt;token&gt;&quot; -e SLACK_SUBDOMAIN=&quot;&lt;team-name&gt;&quot; now-examples/slackin</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Jdu14gnFx5vvGGOO6FrTyQ.png" /><figcaption>Deploy to ZEIT</figcaption></figure><p>That’s all you need to do, and once the app is deployed, a new URL (<a href="https://now-examples-slackin-hzqfnemqkc.now.sh/">example</a>) for the landing page will be created and ready to share.</p><ol><li><strong>Landing Page </strong><em>(</em><a href="http://now-examples-slackin-hzqfnemqkc.now.sh/"><em>Demo</em></a><em>)</em></li></ol><figure><img alt="" src="https://cdn-images-1.medium.com/max/616/1*ry6ZAUOO353oDhs-sunlVA.png" /><figcaption>Image <a href="https://www.producthunt.com/posts/slackin-2#comment-87632">Credit</a></figcaption></figure><p><strong>2. Badge </strong><em>(</em><a href="http://now-examples-slackin-hzqfnemqkc.now.sh/badge.svg"><em>Demo</em></a><em>)</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/386/1*ljalLAAdMkMfizqjRTjFjg.png" /></figure><p><a href="https://github.com/rauchg/slackin#realtime-demo"><strong>3. Realtime Subscription</strong></a><strong> </strong><em>(</em><a href="https://jsbin.com/xoqoxaleke/edit?output"><em>Demo</em></a><em>)</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/291/1*uh1SrU4WPGSnll9FwlT3RQ.gif" /><figcaption>Image <a href="https://www.producthunt.com/posts/slackin-2#comment-87632">Credit</a></figcaption></figure><p>The landing page URL will be similar to <a href="https://now-examples-slackin-hzqfnemqkc.now.sh/">now-examples-slackin-hzqfnemqkc.now.sh</a>, and of course, customizing this URL to a subdomain would be another great step. I think <a href="https://zeit.co/now#pricing">ZITE Premium</a> enables custom domain support, for now, I created a Masked URL Redirect Record with <a href="http://bit.ly/aspire-namecheap">NameCheap</a> and by doing this I can access the landing page from <a href="http://slack.aspirethemes.com/">slack.aspirethemes.com</a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/940/1*Oyhvc0mSy6QmNTSf26p82A.png" /><figcaption>Masked URL Redirect Record</figcaption></figure><p>I hope this will help you create your next Slack Channel, and if there any tips or recommendations you like to share, I would be happy to hear and learn from you.</p><h4>Did you enjoy this post? Why not give it some ❤️ or a share? Also, if you are looking for a new WordPress, Ghost, or Jekyll theme, check out <a href="https://aspirethemes.com/">Aspire Themes</a> 👌</h4><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=1825c1d3efb2" width="1" height="1" alt=""><hr><p><a href="https://medium.com/aspirethemes/create-your-own-public-slack-chat-community-with-slackin-1825c1d3efb2">Create Your Own Public Slack Chat Community with Slackin</a> was originally published in <a href="https://medium.com/aspirethemes">Aspire Themes</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Tools I Use to Create Premium WordPress and Ghost Themes]]></title>
            <link>https://medium.com/aspirethemes/tools-i-use-to-create-premium-wordpress-and-ghost-themes-3654c3d2b80c?source=rss-df7b08d297e7------2</link>
            <guid isPermaLink="false">https://medium.com/p/3654c3d2b80c</guid>
            <category><![CDATA[themes]]></category>
            <category><![CDATA[ghosts]]></category>
            <category><![CDATA[wordpress]]></category>
            <category><![CDATA[themeforest]]></category>
            <category><![CDATA[web-development]]></category>
            <dc:creator><![CDATA[Ahmad Ajmi]]></dc:creator>
            <pubDate>Fri, 09 Sep 2016 17:04:40 GMT</pubDate>
            <atom:updated>2018-02-03T18:24:07.534Z</atom:updated>
            <content:encoded><![CDATA[<p>At <a href="https://aspirethemes.com/?utm_source=medium&amp;utm_medium=articles">Aspire Themes</a>, I use a lot of tools to help me create WordPress, Ghost and Jekyll themes. Tools will range from development, design, services, hosting and automation tools for making my life easier as a one man shop, and It might be helpful for someone else in a way or another starting their journey as a theme creator or a developer; so I’m so happy to share them with you.</p><h4>Mamp</h4><p>I use <a href="https://www.mamp.info/">Mamp</a> to run my development WordPress installation on Mac, it’s very easy to use and I use the free version and it did what I need.</p><h4>Bitnami</h4><p>This service is just awesome, I use the <a href="https://bitnami.com/stack/ghost">Ghost Stack</a> to install Ghost locally. This saves a lot of time and headache installing Ghost, and by using it, we I avoid issues like <em>Node.js </em>versions conflicts and issues regarding <em>npm</em> installation and other infinite numbers of issues. The Bitnami stack provides a one-click install solution for Ghost, and with a few minutes, you will have Ghost installed and ready for working.</p><h4>Visual Studio Code</h4><p>I used to use Sublime before, but after I discovered <a href="https://code.visualstudio.com/">Visual Studio Code</a>, I switched to it from the first usage, it’s very fast, smooth, huge community with lots of <a href="https://marketplace.visualstudio.com/VSCode">extensions</a> and gets updates regularly, and I totally recommend checking it out.</p><h4>iTerm + tmux</h4><p><a href="https://www.iterm2.com/">iTerm</a> is a replacement to Mac terminal, and I think most of you are using it for Mac.</p><p><a href="https://tmux.github.io/">tmux</a> is a terminal multilpexer and a pretty great tool.</p><blockquote><strong>What is a terminal multiplexer?</strong> It lets you switch easily between several programs in one terminal, detach them (they keep running in the background) and reattach them to a different terminal. And do a lot more.</blockquote><p>It saves a lot of time by letting you focus on one terminal, create more sessions and more windows as you need on that session, very flexible and will change the way you work with the terminal.</p><h4>BashScript</h4><p>I wrote a post explaining how I use BashScript to automate theme deployment to remote servers, which is a time saver for me, especially on testing themes while doing development.</p><p><a href="https://medium.com/aspirethemes/push-wordpress-and-ghost-themes-to-digitalocean-with-bash-script-ba1f86161f31">Push WordPress and Ghost Themes to DigitalOcean with Bash Script</a></p><h4><strong>Git</strong></h4><p><a href="https://git-scm.com/">Git</a> should be one of the first things to learn as a developer. Currently, I use the <a href="http://nvie.com/posts/a-successful-git-branching-model/">git-flow workflow</a> which is a great way to organize and manage the way I work with branches, adding new features, fixing bugs, .. etc</p><h4><strong>BitBucket</strong></h4><p>By using Git it’s very important to host all the themes and work on a remote server like <a href="https://github.com/">GitHub</a> or <a href="http://bitbucket.org/">BitBucket</a>. I use BitBucket to host my work as it’s a free option with unlimited private repositories.</p><h4>Pixelmator</h4><p><a href="http://www.pixelmator.com/mac/">Pixelmator</a> is a great image editor for Mac, I use it all the time to create themes preview images, and any image customization I need. Pixelmator costs about $30.</p><h4>Trello</h4><p><a href="https://trello.com/">Trello</a> is a very good tool for managing many things, a column for different blog system with a card for every theme to attach the new to do, issues, and everything related to that theme.</p><p>I also use it for managing design inspiration for different places, and when I have an idea of a new theme, I create a separate column with different inspiration links for different patterns. Simply, it’s my place of everything whether it’s planning, to do, resources or ideas.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*UB2_PPZoVznqYx182B2pWg.png" /><figcaption>Trello Boards</figcaption></figure><h4><strong>iOS Simulator</strong></h4><p>A few weeks ago I received an email from a client who purchased the <a href="https://aspirethemes.com/themes/magaz-ghost.html">Magaz</a> Ghost theme and found an issue on iPad regarding the posts grid on the home page. I tried to debug the issue on the Chrome dev tools as I don’t have an iPad, but I wasn’t able to reproduce the issue. I remembered that I have tried the iOS Simulator that comes with Xcode; so I opened the simulator and picked iPad Device from the Hardware menu, and now I can see the issue.</p><p>The great thing about the Simulator is that I can test the web page natively on different devices and also debug with Safari dev tools and this is a big win for using the iOS Simulator.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FOVGv1KbBR6u7zz_saq3ew.png" /><figcaption>Testing on iPhone 6 Plus/iOS 8.3 &amp; Debugging with Safari Dev Tools</figcaption></figure><h4><strong>Gulp</strong></h4><p><a href="http://gulpjs.com/">Gulp</a> is a JavaScript task runner that could save a lot of time while developing themes, and it’s one of the most important tools I use, for assets automation, I use it with Sass, JavaScipt, and everything that I think I do repeat a lot and I should automate it instead.</p><p><a href="https://www.sitepoint.com/wordpress-theme-automation-with-gulp/">WordPress Theme Automation With Gulp</a></p><p>I also use it to generate the <em>rtl.css</em> file that is used for WordPress RTL sites, you can read more about this in a post I wrote before.</p><p><a href="https://medium.com/aspirethemes/add-rtl-support-to-wordpress-theme-with-sass-and-gulp-b9df2e3d6e65">Add RTL Support to WordPress Theme with Sass and Gulp</a></p><p>You can check a real example of a <em>gulpfile.js</em> I use at <a href="https://gist.github.com/ahmadajmi/c8540178238a6e36601f690e818e7448">GitHub</a>.</p><h4><strong>Sass</strong></h4><p><a href="http://sass-lang.com/">Sass</a> is a powerful tool for writing modular and organized CSS, organizing the source code into components, sections, and variables make life easier for developers instead of one big file of CSS, using variables, mixins, and other features will change the way you write raw CSS.</p><p>Recently I started using <a href="http://itcss.io/">ITCSS</a> as an architecture for writing CSS, and I highly recommend it. I created this <a href="https://github.com/ahmadajmi/awesome-itcss">awesome-list</a> for articles, videos, and code examples, you can also take a look at Aspire Themes website <a href="https://github.com/aspirethemes/aspirethemes.github.io/tree/master/_sass">code</a> as an example.</p><h4>WordPress Tools</h4><p>For better WordPress development and for getting great results and to make sure themes are coded with best practices and validated, there are some plugins and tools that are essentials in my workflow.</p><p><a href="http://wordpress.org/extend/plugins/developer/"><strong>Developer Plugin</strong></a><strong>: </strong>This is the first plugin to install to check and optimize the development environment for tools and plugins that will help you develop better themes with a better quality.</p><p><a href="https://wordpress.org/plugins/rtl-tester/"><strong>RTL Tester</strong></a><strong>: </strong>If you support RTL, then this plugin is a must as it tests themes in RTL mode.</p><p><a href="https://wordpress.org/plugins/theme-check/"><strong>Theme Check</strong></a><strong>:</strong> To make sure that the theme is compatible with WordPress standards, this is an amazing plugin to be in your arsenal.</p><p><a href="https://codex.wordpress.org/Theme_Unit_Test"><strong>Theme Unit Test</strong></a><strong>: </strong>Which generates some dummy content data for testing all kinds of content. I also recommend you to add some real content with good looking images that feels like a content other than unreadable text like Lorem Ipsum.</p><p><a href="http://wordpress.org/extend/plugins/monster-widget/"><strong>The Monster Widget</strong></a><strong>: </strong>This plugin will add all core widgets to the sidebar for testing, which is perfect for optimizing widget styles in different places, so if you support widgets in the footer make sure to activate this widget there to make sure that all widgets styles are looking as you want in different places.</p><p><a href="https://managewp.com/"><strong>ManageWP</strong></a><strong>: </strong>A great online tool to manage WordPress websites from one dashboard, I use it mainly to update plugins for themes demos, which saves me lots of time opening every site to do the updates.</p><h3><strong>Hosting</strong></h3><p>An important thing about creating premium themes is to create a complete demo site for the theme, and of course, you need a hosting service for creating a demo for every single theme, I have tried several options and here are the ones I currently use.</p><h4><strong>DigitalOcean</strong></h4><p>I use <a href="http://bit.ly/aspire-digitalocean">DigitalOcean</a> to host WordPress and Ghost themes. For WordPress, I created a Droplet and connected it with the awesome <a href="https://serverpilot.io/">ServerPilot</a> service, which makes creating WordPress sites as speed as a rocket. Currently, I host all WordPress demos (5 demos) on one $5 Droplet.</p><p>I also host 5 Ghost demos on one 5$ Droplet, this absolutely saves a lot of time and energy managing all the instances if they are in separate droplets, plus it is a very cost effective.</p><p>You can read about how to host multiple instances in the following article.</p><p><a href="https://www.digitalocean.com/community/tutorials/how-to-serve-multiple-ghost-blogs-on-one-vps-using-nginx-server-blocks">How To Serve Multiple Ghost Blogs on One VPS Using Nginx Server Blocks | DigitalOcean</a></p><h4>Netlify</h4><p>I use <a href="https://www.netlify.com/">Netlify</a> to host Jekyll themes and I can say that it’s the one that I was looking for, very developer friendly and integrated with different other apps like BitBucket and GitHub.</p><p>It’s very easy to setup with Jekyll or any static website, just link your repository and you are done, and everyone you push a new update to the remote repo, Netlify will build the website automatically for you with a free domain name which you can change later to a custom domain.</p><h4>Jekyll</h4><p>I use Jekyll for <a href="https://aspirethemes.com/?utm_source=medium&amp;utm_medium=articles">Aspire Themes</a> website which includes several sections like the <a href="https://aspirethemes.com/blog/?utm_source=medium&amp;utm_medium=articles">blog</a>, <a href="https://aspirethemes.com/docs/?utm_source=medium&amp;utm_medium=articles">documentations</a>, <a href="https://aspirethemes.com/about/?utm_source=medium&amp;utm_medium=articles">about</a>, and the <a href="https://aspirethemes.com/themes/?utm_source=medium&amp;utm_medium=articles">themes</a> page with a separate page for every theme. The source code is available on <a href="https://github.com/aspirethemes/aspirethemes.github.io">GitHub</a>.</p><p>Jekyll is very flexible in the way you can structure your site as needed and all is done in text, no databases, no queries, just a simple markup language and markdown files — which we love as developers — and then you can host the site for free on <a href="https://pages.github.com/">GitHub Pages</a>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/719/1*PM1c_vNXqO0Zx3jLApoR3Q.png" /><figcaption>Performance Test With Google Speed</figcaption></figure><p>I also use Netlify for deployment, and with a few minutes, you can also add a free SSL certificate to the website.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/673/1*wCxP9KpnKWersFJErOsSLw.png" /><figcaption>HTTPS enabled by <a href="https://www.netlify.com/">Netlify</a> for aspirethemes.com</figcaption></figure><p>I will write a post about how I built the website and how the structure is going.</p><h4><strong>Namecheap</strong></h4><p>I started to use <a href="http://bit.ly/aspire-namecheap">Namecheap</a> recently and I like their services and the web dashboard interface is very understandable and easy to use. They also provide a great online customer support, and I recommend them if you are looking to buy a new domain.</p><p>I hope you find the post useful exploring a new tools and tips that I use on a day to day work, that will help you start your next theme shop or even use them in your daily development workflow. Let me know if there any tools you can recommend if you are a theme author or a developer, also if you have any questions, I would be happy to discuss them with you.</p><h4>Did you enjoy this post? Why not give it some ❤️ or a share?</h4><h4>Also, if you are looking for a new WordPress, Ghost, or Jekyll theme, check out <a href="https://aspirethemes.com/">Aspire Themes</a> 👌</h4><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=3654c3d2b80c" width="1" height="1" alt=""><hr><p><a href="https://medium.com/aspirethemes/tools-i-use-to-create-premium-wordpress-and-ghost-themes-3654c3d2b80c">Tools I Use to Create Premium WordPress and Ghost Themes</a> was originally published in <a href="https://medium.com/aspirethemes">Aspire Themes</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Push WordPress and Ghost Themes to DigitalOcean with Bash Script]]></title>
            <link>https://medium.com/aspirethemes/push-wordpress-and-ghost-themes-to-digitalocean-with-bash-script-ba1f86161f31?source=rss-df7b08d297e7------2</link>
            <guid isPermaLink="false">https://medium.com/p/ba1f86161f31</guid>
            <category><![CDATA[wordpress]]></category>
            <category><![CDATA[digitalocean]]></category>
            <category><![CDATA[web-development]]></category>
            <category><![CDATA[bash]]></category>
            <category><![CDATA[wordpress-themes]]></category>
            <dc:creator><![CDATA[Ahmad Ajmi]]></dc:creator>
            <pubDate>Wed, 10 Aug 2016 08:22:50 GMT</pubDate>
            <atom:updated>2017-05-24T10:10:03.447Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*dwYDOmQBEODURiBerp1ewA.png" /></figure><p>While we develop themes as developers, we need to test them with a remote server, and this test happens a lot of times a day while working. This requires to move to the themes directory, zip the theme file, login to the server using ssh, then push the zip file to the remote server, then login to WordPress to activate the theme, or in the Ghost case, we need to restart the Ghost server for changes to reflect. All of these processes will take a lot of time and they are boring to do again and again.</p><p>I have searched on how I can automate compressing a theme, pushing a theme to a remote server, then I can do anything I want on the server, for example, I can restart the Ghost server so the new changes will reflect, and so on. All of this could be done using a simple BashScript file.</p><p>This is the script I did to push a WordPress theme from local machine to a remote server running on DigitalOcean.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/211d877ffa084d578cd144317e3e1160/href">https://medium.com/media/211d877ffa084d578cd144317e3e1160/href</a></iframe><h4>To run the script</h4><p>From the above script, you have to change some variables:</p><p><strong>IP_ADDRESS</strong>: The droplet IP Address</p><p><strong>THEMES_DIR</strong>: The local WordPress themes directory</p><p><strong>REMOTE_THEMES_DIR</strong>: The remote server WordPress themes directory (this is the default path)</p><p><strong>Theme name</strong>: in my case is <strong>aspire</strong></p><p>The script also does a zip file and ignore some folder and files, for example, it ignores the <em>git</em> <em>node_modules</em> directories, you may want to edit this line to your needs.</p><p>Next, you need to give a permission to the file <strong><em>aspire.sh</em></strong>, and then execute the file in the command line.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/e166e196423c27a80d2d83958a0cc22c/href">https://medium.com/media/e166e196423c27a80d2d83958a0cc22c/href</a></iframe><h4>For Ghost</h4><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/3cb37ac04ccbcfbb911d8469ac83c675/href">https://medium.com/media/3cb37ac04ccbcfbb911d8469ac83c675/href</a></iframe><p>This is very similar to the WordPress one, and you will notice that at the bottom we did a sever restart. You can give permission to the file, change variables, … as you need.</p><p>So, this saves me a lot of time doing repetitive tasks every time I need to update and test a theme. Another point is that this type of script will work with any server that you have access to with <strong>ssh, </strong>I have tried it with AWS and Bitnami and it worked fine too<strong>.</strong></p><p>I have created a <a href="https://github.com/aspirethemes/deploy-scripts">GitHub repo</a> for the scripts, you can check it out.</p><p>You can try it and let me know what do you think, and if you have any questions or thought for making this script better.</p><p><em>Did you enjoy this post? Why not give it some </em>❤️ or a share? Also, if you are looking for a new WordPress, Ghost, or Jekyll theme, check out <a href="https://aspirethemes.com/">Aspire Themes</a>.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ba1f86161f31" width="1" height="1" alt=""><hr><p><a href="https://medium.com/aspirethemes/push-wordpress-and-ghost-themes-to-digitalocean-with-bash-script-ba1f86161f31">Push WordPress and Ghost Themes to DigitalOcean with Bash Script</a> was originally published in <a href="https://medium.com/aspirethemes">Aspire Themes</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Add RTL Support to WordPress Theme with Sass and Gulp]]></title>
            <link>https://medium.com/aspirethemes/add-rtl-support-to-wordpress-theme-with-sass-and-gulp-b9df2e3d6e65?source=rss-df7b08d297e7------2</link>
            <guid isPermaLink="false">https://medium.com/p/b9df2e3d6e65</guid>
            <category><![CDATA[wordpress]]></category>
            <category><![CDATA[gulp]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[sass]]></category>
            <dc:creator><![CDATA[Ahmad Ajmi]]></dc:creator>
            <pubDate>Wed, 10 Aug 2016 08:20:08 GMT</pubDate>
            <atom:updated>2018-02-03T18:24:21.425Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*HuHbi6D0rpzsTenMxWgfXg.png" /></figure><p>At <a href="https://aspirethemes.com/?utm_source=medium&amp;utm_medium=articles">Aspire Themes</a>, I always care and provide RTl CSS support for all WordPress themes, this helps many customers and website owners to provide and support more languages like Arabic or Hebrew, or any language that you can read from right to left (RTL).</p><p>I use Gulp as a JavaScript task runner to automate everything in theme development, things like Sass compilation, CSS auto-prefix, JavaScript validation, browser refresh, … and In this post, I will use <a href="https://www.npmjs.com/package/gulp-rtlcss">gulp-rtlcss</a> and <a href="https://www.npmjs.com/package/gulp-rename">gulp-rename</a> plugins to generate the RTL CSS file (rtl.css).</p><p>I assume you have some experience with <a href="http://gulpjs.com/">Gulp</a>, Node.js are installed in your system and have WordPress installed and configured.</p><p>I will use the <a href="http://underscores.me/">underscore</a> as the base theme. You can download it and activate from the dashboard.</p><p>Then, navigate to the theme directory using the command line, like:</p><pre>cd ~/www/wordpress/wp-content/themes/wordpress-rtl-with-gulp</pre><p>While you are in the theme directory, run the <em>npm init</em> command and follow a few simple steps to create a <em>package.json</em> file which will include some information about the theme and the packages that will be installed.</p><p>An example of <em>package.json</em> that you will get after finishing up the steps.</p><pre>{<br>  &quot;name&quot;: &quot;Wordpress RTL with Gulp&quot;,<br>  &quot;version&quot;: &quot;1.0.0&quot;,<br>  &quot;description&quot;: &quot;Add RTL Support to WordPress Theme with Sass and Gulp&quot;,<br>  &quot;author&quot;: &quot;Aspire Themes&quot;<br>}</pre><p>Install the required Gulp plugins:</p><pre>npm install gulp gulp-sass gulp-rtlcss gulp-rename --save-dev</pre><p>Next, create a Sass directory with a basic structure</p><pre>├── sass<br>│   └── style.scss</pre><p>The <em>style.scss</em> is the main starting point file, which will include all your components, modules, functions inside it based on your preference. You can copy the content of <em>style.css</em> file into <em>style.scss</em> or you can create your own styles, and in this case, <em>style.css</em> will be overwritten by your new styles.</p><pre><em>/*<br>  Theme Name: Aspire<br>  Theme URI: </em><a href="http://aspirethemes.com/"><em>http://aspirethemes.com</em></a><em><br>  Author: Aspire Themes<br>  Author URI: </em><a href="http://aspirethemes.com/"><em>http://aspirethemes.com</em></a><em><br>  Description: Add RTL Support to WordPress Theme with Sass and Gulp<br>  Version: 1.0.0<br>  License:<br>  License URI:<br>  Text Domain: aspire<br>*/</em></pre><pre>body {<br>  text-align: left;<br>  direction: ltr;<br>}</pre><pre><strong>.column</strong> { float: left; }</pre><p>The next step is to create a <em>gulpfile.js</em> file and include the newly installed plugins and add the sass task.</p><pre><strong>var</strong> gulp    <strong>=</strong> require(&#39;gulp&#39;),<br>    sass    <strong>=</strong> require(&#39;gulp-sass&#39;),<br>    rtlcss  <strong>=</strong> require(&#39;gulp-rtlcss&#39;),<br>    rename  <strong>=</strong> require(&#39;gulp-rename&#39;);</pre><pre>gulp.task(&#39;sass&#39;, <strong>function</strong>() {<br>  <strong>return</strong> gulp.src(&#39;./sass/*.scss&#39;)<br>  .pipe(sass())<br>  .pipe(gulp.dest(&#39;./&#39;))              <em>// Output LTR (style.css)</em></pre><pre>  .pipe(rtlcss())                     <em>// Convert to RTL</em><br>  .pipe(rename({ basename: &#39;rtl&#39; }))  <em>// Rename to rtl.css</em><br>  .pipe(gulp.dest(&#39;./&#39;));             <em>// Output (rtl.css)</em><br>});</pre><p>The idea behind gulp-rtlcss is to convert all the CSS properties like floats, text-align, text direction, and other properties from left to right.</p><p>The second plugin is <a href="https://www.npmjs.com/package/gulp-rename">gulp-rename</a> which will rename the file to <em>rtl.css</em> automatically.</p><p>In this step, the plugin will convert all the CSS properties like floats and text direction from left to right, then rename the file to <em>rtl.css</em> and then output the file to the theme root.</p><p>Now, run gulp from the command line.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/747/0*cKKTuTEUnIm6DTSO.png" /></figure><p>This will generate <em>style.css</em></p><pre><em>/*<br>  Theme Name: Aspire<br>  Theme URI: </em><a href="http://aspirethemes.com/"><em>http://aspirethemes.com</em></a><em><br>  Author: Aspire Themes<br>  Author URI: </em><a href="http://aspirethemes.com/"><em>http://aspirethemes.com</em></a><em><br>  Description: Add RTL Support to WordPress Theme with Sass and Gulp<br>  Version: 1.0.0<br>  License:<br>  License URI:<br>  Text Domain: aspire<br>*/</em><br>body {<br>  text-align: left;<br>  direction: ltr; }</pre><pre><strong>.column</strong> {<br>  float: left; }</pre><p>and <em>rtl.css</em> files.</p><pre><em>/*<br>  Theme Name: Aspire<br>  Theme URI: </em><a href="http://aspirethemes.com/"><em>http://aspirethemes.com</em></a><em><br>  Author: Aspire Themes<br>  Author URI: </em><a href="http://aspirethemes.com/"><em>http://aspirethemes.com</em></a><em><br>  Description: Add RTL Support to WordPress Theme with Sass and Gulp<br>  Version: 1.0.0<br>  License:<br>  License URI:<br>  Text Domain: aspire<br>*/</em><br>body {<br>  text-align: right;<br>  direction: rtl; }</pre><pre><strong>.column</strong> {<br>  float: right; }</pre><p>Notice that, left becomes right, and direction <em>ltr</em> becomes <em>rtl</em> automatically.</p><p>I’ve created a GitHub repo for this article’s WordPress theme and <a href="https://github.com/aspirethemes/wordpress-rtl-with-gulp">you can check out the code here</a>.</p><h3>Conclusion</h3><p>Gulp makes the development process much easier than before, not only compiling Sass to CSS, or generating the RTL file, but for many other tasks like CSS auto-prefixing, JavaScript validation, watching files and much more, and I highly recommend to add it to your development arsenal.</p><p>Have you tried to work and generate WordPress <em>rtl.css</em> file before, what was your experience? If you use Gulp in your development workflow, which plugins do you use regularly and recommend?</p><h4>Did you enjoy this post? Why not give it some ❤️ or a share?</h4><h4>Also, if you are looking for a new WordPress, Ghost, or Jekyll theme, check out <a href="https://aspirethemes.com/">Aspire Themes</a> 👌</h4><p><em>Also published on </em><a href="https://aspirethemes.com/blog/rtl-wordpress-with-sass"><em>Aspire Themes blog</em></a><em>.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b9df2e3d6e65" width="1" height="1" alt=""><hr><p><a href="https://medium.com/aspirethemes/add-rtl-support-to-wordpress-theme-with-sass-and-gulp-b9df2e3d6e65">Add RTL Support to WordPress Theme with Sass and Gulp</a> was originally published in <a href="https://medium.com/aspirethemes">Aspire Themes</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>