Dev Docs
  • Disciple.Tools Technical Documentation
  • Theme Core
    • API - Posts
      • List of Endpoints
      • Fields Format
      • Get Post
      • Create Post
      • Update Post
      • Post Comments
      • Post Activity
      • List Query
      • Global Search
      • Posts in Typeaheads
      • Post-Sharing
      • Get Following
      • Settings
    • API - Other
      • Users
      • Locations
      • Settings
    • Hooks
      • Record Page Hooks
      • API-Hooks
      • Public settings
      • Adding menu navigation links
    • Customization
      • Fields
      • Custom Post Types
      • Post Type Modules
      • Adding Fields and Tiles.
    • Authentication
      • JWT-Authentication-for-the-mobile-app
      • Site-to-Site-Link
      • Easy-Example
    • Permissions
    • Roles and Permissions
    • Database Tables
      • Activity Table
    • Disciple.Tools Translation
    • Revisions
      • v1.0.0-dev-changes
      • v1.0
  • Hosting
    • 404 Errors on new install
    • CRON
    • Hosting on WPEngine
    • Backups
    • Single Site or MultiSite
  • Disciple.Tools Development Setup
    • LocalWP
    • Mobile App Setup
    • Unit Tests
    • Cypress Tests
    • D.T on Docker Setup
    • Gulp - CSS and JS
  • Code Contribution
    • Theme Contribution Guidelines
    • How to Correctly Contribute to the Disciple Tools Repository
    • How to Translate Your Plugin
  • Style Guide
  • Disciple.Tools Code of Conduct
Powered by GitBook
On this page

Was this helpful?

Edit on Git
  1. Disciple.Tools Development Setup

LocalWP

PreviousDisciple.Tools Development SetupNextMobile App Setup

Last updated 3 years ago

Was this helpful?

provides a simple way to configure a WordPress development environment.

  1. Install LocalWP on your machine:

    a. Download the appropriate installer for your platform from the list on:

    • If a dialog asking for your platform type appears, you must have pressed the DOWNLOAD button in the upper right of the web page instead - You do not have to fill in all the information, but you must give your email address.

    • The installer should download automatically, if not then follow the instructions

    b. Installing LocalWP on MacOS and Linux is straight forward. For Windows, especially with a 3rd-party antivirus, it requires more effort.

    Note: Some VPNs set firewalls on your network configuration, which will likely conflict with LocalWP.

    Installing on Windows

    • Select install for all users (requires Administrator privileges).

    • Run Local but do not create a website yet, LocalWP needs to be able to write to your c:\Windows\System32\Drivers\etc\hosts file and set up SSL. Your antivirus will not like this so you must first “whitelist” Local.

    • As an example: if you use Kapersky 2020, these are the steps: 1. In the main windows go to More Tools -> Manage applications -> Application Controls -> Manage applications 2. In the search box type “local” 3. Double click on Local.exe – Be careful it is the right application! 4. Under Exclusions check:

      • [X] Do not monitor application activity

      • [X] Do not inherit restriction from the (application's) parent process

      • [X] Do not monitor the activity of child applications

      • Press "Save"

  2. LocalWP will ask if you want to create a new site, or press the large ✚ in the lower left corner.

    a. Provide a site name and choose ADVANCED OPTIONS to change defaults 1. Change the site domain and browse for where you want your site’s code to be stored. (You may need to create the folder) e.g. Name: D.T Local site path: D:\sandbox\DT (e.g. as a Windows path) 2. Select “CONTINUE”

    b. Choose “Preferred” environment 1. Select “CONTINUE”

    • Select the custom option with different values if you run into an issue.

    c. Provide WordPress Username, Password and Email address

    • If you wish the site to be Multisite, select this under ADVANCED OPTIONS

    • Select “ADD SITE”

    d. Wait for WordPress, etc. to be downloaded and the site to be created

    • Warning: This can fail if there is no write access to your hosts file, or your antivirus does not give LocalWP sufficient permissions.

    • In Windows: if you are not running as an administrator you will need to give it permission to update the hosts file.

    • This and other changes will need admin approval. An alternative is to change the LocalWP shortcut’s Properties -> Advanced… so it always runs as Administrator, but this can cause security issues.

    e. You can access your site via both http:// and https://

    • LocalWP will create an SSL certificate if you select the TRUST button (which will bypass your browser’s security warning)

    • e.g. If the site’s name is D.T, then both addresses will work http://dt.local and https://dt.local

  3. Install Theme. See

    1. Follow installation instructions:

    2. Download latest release:

  4. Some plugins are available for installation from the Extensions tab

    If you need the latest plugin, download the zip files from GitHub, and install plugins using these instructions:

    • e.g.

LocalWP
https://localwp.com/community/
(source)
https://github.com/DiscipleTools/disciple-tools-theme
https://github.com/DiscipleTools/disciple-tools-theme#how-to-install
https://github.com/DiscipleTools/disciple-tools-theme/releases/latest/download/disciple-tools-theme.zip
https://wordpress.org/support/article/managing-plugins/#manual-upload-via-wordpress-admin
https://github.com/DiscipleTools/disciple-tools-demo-content
Kapersky Settings