{"id":15286331,"url":"https://github.com/asha23/arlo-framework","last_synced_at":"2025-04-13T03:09:56.261Z","repository":{"id":62488515,"uuid":"68832040","full_name":"asha23/arlo-framework","owner":"asha23","description":"A Composer Framework to help you get WordPress up and running in around a minute","archived":false,"fork":false,"pushed_at":"2023-12-15T02:51:04.000Z","size":2341,"stargazers_count":3,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-13T03:09:50.022Z","etag":null,"topics":["base-framework","bower","composer","framework","seed-theme","theme","wordpress","wordpress-boilerplate","wordpress-bootstrap","wordpress-composer-skeleton","wordpress-framework","wordpress-starter-framework","wordpress-theme","yarn"],"latest_commit_sha":null,"homepage":"https://asha23.github.io/arlo/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/asha23.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-09-21T15:38:35.000Z","updated_at":"2022-09-26T01:55:32.000Z","dependencies_parsed_at":"2024-09-30T15:23:13.557Z","dependency_job_id":null,"html_url":"https://github.com/asha23/arlo-framework","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asha23%2Farlo-framework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asha23%2Farlo-framework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asha23%2Farlo-framework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asha23%2Farlo-framework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/asha23","download_url":"https://codeload.github.com/asha23/arlo-framework/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248657917,"owners_count":21140846,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["base-framework","bower","composer","framework","seed-theme","theme","wordpress","wordpress-boilerplate","wordpress-bootstrap","wordpress-composer-skeleton","wordpress-framework","wordpress-starter-framework","wordpress-theme","yarn"],"created_at":"2024-09-30T15:13:03.336Z","updated_at":"2025-04-13T03:09:56.242Z","avatar_url":"https://github.com/asha23.png","language":"PHP","readme":"# Arlo\n### A Wordpress/Composer framework.\n\n```\ncomposer create-project asha23/arlo-base-wordpress your-folder-name\n```\n\n[![GitHub issues](https://img.shields.io/github/issues/asha23/arlo-framework.svg)](https://github.com/asha23/arlo-framework/issues) [![GitHub forks](https://img.shields.io/github/forks/asha23/arlo-framework.svg)](https://github.com/asha23/arlo-framework/network) [![GitHub stars](https://img.shields.io/github/stars/asha23/arlo-framework.svg)](https://github.com/asha23/arlo-framework/stargazers) [![Twitter](https://img.shields.io/twitter/url/https/github.com/asha23/arlo-framework.svg?style=social)](https://twitter.com/intent/tweet?text=Wow:\u0026url=%5Bobject%20Object%5D)\n\nThis assumes prior knowledge of how to set up WordPress themes. Feel free to make improvements to this.\n\nIt's very (very) loosely based on Bedrock, but with a much more simplified method for differentiating between dev/staging/production databases. I found that for most of my working practice I simply didn't need a lot of what Bedrock offered and decided to use it's methodologies as a starting point, but keep it a hell of a lot simpler.\n\nIf you like Bedrock, then great! It's pretty awesome, so fill your boots. But if you find it a little overcomplicated and a tiny bit bloated like I do, then this framework/approach might be more up your alley.\n\nYou can get up and running with a complete WordPress environment in about a minute.\n\n## Basic installation instructions\n\n* Create a new repository for your project\n* Download this as a zip file and unzip into the repository - https://bitbucket.org/this-is-pegasus-team/pegasus-wordpress-composer/get/master.zip\n* Open a terminal and browse to the folder you are using\n* Install Composer - https://getcomposer.org/\n* Install Node - https://nodejs.org/en/\n* Install Bower - https://bower.io/\n* Install Yarn - https://yarnpkg.com/\n* Rename .env-example to .env and fill out the relevant fields.\n* Once you have Composer installed, then you need to run ```$ composer install```. This will install all the base plugins and a seed theme into the correct directories.\n* Send an initial commit to your repository\n* Get started.\n\n```\ncomposer create-project asha23/arlo-base-wordpress your-folder-name\n```\n\nRequirements\n============\n\nYou should get a license for Advanced Custom Fields pro for this framework.\n\nGetting started\n===============\n\nThere is a Vagrant file in the folder which uses a version of Scotchbox for Vagrant:  \nRun ```vagrant up``` from the root folder (Not currently tested) - Your website will then be available on\n\n```\n192.168.33.10\n```\n\n#### The following information should be used to connect to the database\n\nMySql Host: 127.0.0.1  \nUsername: root  \nPassword: root\n\nSSH Host: 192.168.33.10  \nSSH User: vagrant  \nSSH Password: vagrant  \n\nAlternatively, just use MAMP. Or something like https://www.themejuice.it, which provides an excellent and user-friendly environment for locally developing with WordPress. Or any other method you like for deploying locally.\n\nVagrant is the recommended method as it keeps everything self contained.\n\n\n## .env-example file\n\nThere is a .env-example file in the root. You should fill out the relevant information in this file and then re-save it as .env. Once you have done this, you can then edit the web/wp-config.php file and add salts, or do other configurations.\n\nThere is information for 3 environments contained here, development, production and staging. Filling out this information correctly will make sites easier to deploy as it will auto-detect which database to use depending on your environment.\n\n## Notes on the .gitignore.\n\nThis installation by default ignores everything but your theme. You will need to create a deployment of wordpress on your production environment and run composer install. \n\nIf you can't do this simply upload the files as required. I decided to not include all the WordPress stuff in the repo because in the most part it's an uneccesary step really.\n\nFeel free to edit the .gitignore file though if you want to change this.\n\n\n## Notes about the seed theme\n\n[You can view the seed theme repo here](https://github.com/asha23/wp-seed)\n\nThis theme uses Gulp for compilation and Bower for JavaScript dependency management. It is also based around SASS Bootstrap 3.\n\nThe main folder structure is as follows:\n\n```\nweb/content\nweb/wp\n```\n\nThe content folder contains all the themes, plugins and files for the front-end.\n\nThe wp folder is the base WordPress installation - You should not change anything in here.\n\n# Theme Setup\n\nFirst off, navigate to the themes folder. ```web/content/themes/wp-seed```. You should rename this to reflect the project name and change the information in styles.css\n\nYou will need node.js, npm and Yarn installed on your computer before starting:\n\nhttps://nodejs.org/en/   \nhttps://yarnpkg.com/\n\nYou should install Gulp globally if it's not already installed on your machine.\n\n    $ yarn add gulp -g\n\nInstall bower if it's not already installed on your machine\n\n    $ yarn add -g bower\n\n\nStep by step:\n------------------------------------------------\n\nThe seed theme uses Gulp and Yarn for dependency management. Yarn is a dependency manager created by Facebook and it seems to be way faster than using npm. It will pick up all your npm dependencies and use them, so it's very similar\n\nIn your terminal, cd into your theme directory and execute\n\n    $ bower install\n    $ yarn\n\nThis will get everything set up, ready for you to start developing with the theme.\n\n\nGulp commands\n------------\n\n    $ gulp watch\n    $ gulp images\n    $ gulp\n\n```\ngulp watch\n```\n\nwill start the watch task and\n\n```\ngulp images\n```\n\nwill run an image optimisation on the images folder (useful before deployment) - Run\n\n```\ngulp\n```\n\non it's own to do the tasks once.\n\n\nwp-seed Folder Structure\n================\n\nInside the theme, you will find the following structure. This assumes you know a bit about WordPress theming techniques. It's essentially a bare bones sensible structure.\n\n/acf-json\n--------\n\nThis is for use with Advanced Custom Fields. You will find some fields already set up here for dealing with global site options. Use as you wish. You should make sure that you have Advanced Custom Fields Pro installed.\n\n/build\n-----\n\nThis is the build folder for deployment. You will find the images and fonts folder in here. You shouldn't save anything else into this folder, as Gulp will compile everything for you\n\n/includes\n--------\n\nThis is all the core theme php. Files in here are included from the site's root functions.php file. Generally speaking you shouldn't need to edit anything in here apart from custom-post-types.php and menus.php - There is a helper-functions.php file which you can add any handy snippets to.\n\n/library\n-------\n\nThis is where you can edit your ```styles.scss``` file and also ```scripts.js``` - This is also where all the Bower components are added.\n\n/views\n-----\n\nIf you use WordPress Template parts correctly (or standard php includes if you'd prefer), you can separate site content into this views folder.\n\n/bower\n------\n\nThis will automatically be added as soon as you run ```bower install```.\n\n\n\nNotes on the Gulpfile.js\n========================\n\nThis file contains all the path structures for connecting up your Bower dependencies, it's relatively straightforward to create links to any new Bower components and dependencies you want to add to the compilation process.\n\nWe pull the scripts into the ```js/vendor-libs``` folder and then compile them into ```scripts.min.js``` in the build folder. You could, if you prefer, directly reference the ```/bower``` folder for the file paths and skip this step.\n\nGenerally speaking, these paths are the only things you should need to touch inside this file, but if you know a better way of doing some of the tasks inside here, then feel free to adjust it to suit your working methods - This Gulpfile is a work in progress.\n\n\n\nNotes on using Bower for dependency management\n==============================================\n\nWhere possible, you should use Bower for any JavaScript or css modules you want to add to this theme. A lot of commonly used libraries and frameworks are now part of the Bower ecosystem. This will make sure that all your dependencies remain intact and that you are always using the most up-to-date version of the library.\n\nIf you haven't been to a project in a while it's worth running a ```bower update``` periodically.\n\n\n\nGeneral notes\n==============================================\n\n```/node_modules```, ```/bower``` ```wp-config``` and many other files are ignored. You shouldn't include these folders in the deployment as it will cause unnecessary bloat. It is preferable that you pull to staging or live from the repository, rather than uploading files via ftp.\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasha23%2Farlo-framework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasha23%2Farlo-framework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasha23%2Farlo-framework/lists"}