NewsLoopVersion 1.0.0 · offline copyGuides

Questions and answers ​

What buyers ask most. Problems with a running site are also covered under Troubleshooting.

Hosting ​

Does it run on shared hosting? Yes. NewsLoop needs PHP 8.3 or newer, MySQL 8.0 or MariaDB 10.6 or newer, and a cron job once a minute. The hosting needs no Node, Redis or queue worker. See What your hosting needs.

Do I need to build anything before uploading? Once. CodeCanyon packages hold source code, so run composer install --no-dev and build the admin with npx pnpm@10 install --frozen-lockfile and npx pnpm@10 run build, on your computer or over SSH. Then upload the folder and open your site. Preparing the files shows each step. You do the same for each new version you upload later.

Can I install it in a folder, such as example.com/news? Not in version 1.0. NewsLoop needs its own domain or subdomain, such as news.example.com, and the installer checks this. Most hosting panels make a subdomain in a minute.

My host only serves public_html. What do I do? Extract the zip into public_html. On Apache and LiteSpeed the site then answers at your domain and keeps its own files private. You can also point the document root at public_html/public. See Installing.

Does it work with Nginx? Yes. Set the server's root to the public folder. Installing on a VPS has a complete server block.

Is there a Docker setup? Not in 1.0. Use a VPS with Nginx and PHP-FPM, as described in Installing on a VPS.

Using NewsLoop ​

Can I try it before going live? Yes. Install it on a test address or on your computer, such as a staging. copy of your domain or localhost. Tick Add demo content in the installer to start with sample articles.

Can I move my WordPress site? Yes. The WordPress importer brings posts, pages, authors, sections, tags, pictures, comments, SEO descriptions and old addresses, which then redirect to the new ones. See Importing.

Which languages does it speak? Readers see the site, emails and the app in English, Arabic (right to left), Spanish, French, Hindi or Bengali. You can add any other language and change any word yourself. The admin is in English. See Languages and translations.

How do I put my logo and brand colours on the site? Without any code. Upload your logo and icon under System → Site settings → General, and set your brand colour under Site → Customise. The Customization guide walks you through it step by step, including what files to prepare and the app's colours.

Can I change how the site looks without coding? Yes. Pick one of the three themes, set the colours, fonts and logo as in the Customization guide, and arrange the home page under Site → Layout (see Your website). To change the templates themselves, see Themes for developers.

How many writers and editors can I have? As many as you like. There are seven built-in roles, and you can make your own. See Users and roles.

AI ​

Do I need AI to use NewsLoop? No. Every AI tool is optional, and the site works fully without a provider.

What does the AI cost? NewsLoop uses your own account with OpenAI, Anthropic (Claude), Google (Gemini), OpenRouter or any OpenAI-compatible server, so you pay the provider directly. With Ollama on your own server it costs nothing per use, as long as your NewsLoop server can reach it over the network (on shared hosting, localhost won't work; see network requirements). You can set a monthly allowance per person, and the usage page shows the cost. See AI tools.

Does it publish AI-written news by itself? No. Rewrites of imported stories always become drafts for a person to review, with the source credited.

The mobile app ​

Do I need a Mac to make the iPhone app? No. The included Codemagic template builds and uploads both apps from the cloud. See Building the app.

When I change the app in the builder, do readers need an update from the store? No. Installed apps download the new layout the next time they open. You only need a new store release when you change the app's name, icon, package ID, or a component needs a newer app version (the builder warns you).

Do I need developer accounts? To publish, yes: a Google Play developer account and an Apple Developer Program membership, both in your own name. The guide covers the store listings, privacy forms and account deletion that both stores ask for.

Money and licences ​

Which payment companies are supported? Stripe, PayPal, Razorpay and Paystack for memberships. Card details never reach your server. See Ads and memberships.

Which CodeCanyon licence do I need? That depends on Envato's terms for how you use it, not on NewsLoop. As a rule of thumb, the Regular License covers one site whose readers don't pay. If readers pay you to use the site, for example through memberships, Envato's terms may require the Extended License. Read Envato's licence terms or ask Envato before you buy.

Updates and safety ​

How do I update? Make a backup on the System page, then upload the new version from your CodeCanyon download over your site, keeping .env, storage and public/uploads. Then open System and press Update the database: it updates the database and clears the caches, so you need no SSH. Your settings, uploads and own themes are kept. See Upgrading to a new version.

Are my settings and keys safe? API keys and passwords you enter are stored encrypted and never sent to the browser. Keep .env and downloaded backups private: they hold your app key. Sensitive screens ask for your password again after 30 minutes.

How do I back up? On the System page: now, daily or weekly, with download and restore. See Backups.

I forgot my admin password. Use Forgot your password? on the sign-in page. That needs email to work (Site settings). Without email, ask another admin to reset it under Users. If you are the only admin and email doesn't work, run this in the site folder (over SSH, or ask your host's support to run it):

bash
php artisan newsloop:reset-password you@example.com

It asks for the new password, then you can sign in with it.

Can I run the automated tests? Yes. The site's folder (Main_File/newsloop-web) includes them: tests/ (Pest, about 970 tests) and phpunit.xml. On a development computer, not your live site:

  1. Run composer install (with the development tools, so without --no-dev).
  2. Create an empty MySQL database called newsloop_testing, which the user in your .env can use. The tests empty it each time.
  3. Run php artisan test.

The app's tests are in its folder (Main_File/newsloop-app/test): run flutter test there.

Support ​

Your purchase includes 6 months of support from us, the author, under Envato's item support policy. You can extend it to 12 months on the item page.