Category: Docs

  • Design and Branding | vendrux

    Design and Branding | vendrux

    The Vendrux News plugin will allow you to customize some aspects of your app directly from your WordPress Dashboard.

    Under “Vendrux News > Configuration > Design” you will find settings for the following:

    Logo

    The logo is displayed in the app’s header and can be uploaded on the following area:

    The logo must be in .PNG format with a transparent background.

    Header Color

    The header color will dictate the colors of your app, keep in mind that the header is displayed in all screens of your app, so it is important to select a color that matches your logo and branding. You can define the header color using the following setting:

    Article List Style

    You can choose between a compact and extended style for the lists, keep in mind that the selected style will be applied to all the different lists in your app, such as: home screen, categories, authors, search results, favorites.

    Below you can see how each style will look like by default:

    The list style can be adjusted using the following setting:

  • How do I delete my app from Google Play?

    You can unpublish an app, when you do, it will no longer appear in the store.To unpublish your app on the Google Play store:

    1. Go to https://market.android.com/publish/Home, and log in to your Google Play account.
    2. Click on the application you want to delete.
    3. Click on the Store Presence menu, and click the “Pricing and Distribution” item.
    4. Click Unpublish

    Now that you’re done with that… if you’d like to build a fast, native mobile app for your content site, check out Vendrux and if you think we could help, get in touch at support@vendrux.com or request a demo.We focus on native apps for content sites, news sites but also information-rich sites, directories, corporate websites. Our service is full featured and includes a customized app, push notifications, maintenance and ongoing updates.

  • Customizing the Home Screen | vendrux

    Customizing the Home Screen | vendrux

    The home screen is, as the name suggests, the first screen that users will see in your app. For that reason it is important to make sure your articles are displayed with all the details your users will look for when choosing a post to read.

    Below you will find a list of all the settings that will affect the design and structure of your app’s home screen and how to use them.

    Article List Style

    You can choose between a compact and extended style for the lists, keep in mind that the selected style will be applied to all the different lists in your app, such as: home screen, categories, authors, search results, favorites.

    Below you can see how each style will look like by default:

    article list style
    article list style 1

    The list style can be adjusted using the following setting under the “Design” area of the Vendrux News Plugin:

    Vendrux News Plugin

    Date Display Options

    Under “Configuration > Settings” you will find a long list of settings, the “Date Display Options” will allow you to determine how the post date should be presented in the lists.

    You can display the dates using what we call pretty dates (e.g. “2 hours ago”, “1 day ago”), or you can set a custom date format.

    For more details on how to use the date formatting you can check this guide: https://www.php.net/manual/en/datetime.formats.date.php

    The “Date Display Options” can be found here:

    Date Display Options

    List Preferences

    The list preferences will allow you to show or hide several details in your article lists, such as:

    • Post date
    • Excerpt
    • Comment count
    • Category
    • Author
    • Image proportions

    Whenever you make changes to these settings, make sure to clear your server/website cache and then close and re-open the app to see the changes taking place.

    Here you can see the settings:

    article list settings

    Excerpt Length

    The excerpt length will determine how many words are displayed in the excerpt when that element is enabled in your lists, we’d recommend using something around 15 and 20.

    excerpt length

    Number of Articles

    The number of articles that are displayed in your lists when they are loaded is an important aspect of the app, the more articles you decide to load, the longer the lists will take to load. Keep in mind that every time the user scrolls down, the same number of articles will be loaded when the user reaches the end of the initial list.

    number of articles

    Default Article Image

    The default article image will be displayed in your lists whenever you don’t have a featured image set for your posts. We’d recommend using a simple image, that matches your branding design.

    The suggested image size is 560px in width x 400px in height.

    default article image

    Custom field in article list

    The “Custom Field in Article List” setting will allow you to display a custom field in the list of articles, for each post.

    In order for the custom field to be displayed you will need to add its

    This feature will be useful in case you have a unique setup on your website, where you use a custom field to store specific information about your posts.

    custom field in article list
  • Customizing your News app | vendrux

    Customizing your News app | vendrux

    Customising your app’s logo, color, menu and content

    Once installed, you will be able to find the Vendrux plugin in your sidebar.

    1. Add your branding

    Under this tab, you will be able to upload your app’s logo, change the navigation bar color, and choose what to show on your app’s home screen.You can also see a quick preview of the app design. To test your app, load your app from the stores and see changes taking place immediately.

    Vendrux News design tab

    2. Configure the Menu

    On the Menu Tab, you will be able to customize your Menu structure, adding pages, categories, custom taxonomies and any URL you’d like to load in the app.You can change all menus in the app, the hamburger menu, tab menu and even a “Sections” menu if your app is using one.

    Screen Shot 2016-01-22 at 21.46.24
  • Showing custom fields in your News app

    Showing custom fields in your News app

    https://www.youtube.com/watch?v=igf_VzuCqdI With Vendrux you have the ability to add any custom code to your app’s post/page layout. Just click on Vendrux in your WordPress admin dashboard, select Settings and then click on the Editor tab. You’ll see something like this:

    Vendrux Code Editor

    Using the Editor, select a “PHP” position within the article screen, like “PHP after Content”. This allows you to add any PHP code and have the result shown below the main article or page contents. Note for “PHP” spaces, you should enter PHP code directly, without the ID, ‘fieldname’, true). Say for example you want to include the value for a book title you’ve reviewed and include the “Title:” text before the value, while checking if the value is actually present for the current post, you’d use this code:

    $title = get_post_meta( $post->ID, ‘title’, true );

    // check if the custom field has a value

    if( ! empty( $title ) ) {

    echo “Book title: “.$title.”
    “;

    }

  • Create Your Firebase Account | vendrux

    Create Your Firebase Account | vendrux

    Google’s Firebase is an app development platform that gives you control over several parts of your app, with it you will be able to track analytics data, crashes, user behavior, ads and much more.Just like other Google services, in order to have a Firebase account, you will need to sign-in with your own Google Account login details here: https://firebase.google.com/

    firebase

    In case you don’t have a Google Account yet, you can register one here: https://accounts.google.com/signup

  • Convert your Apple Developer Program from Individual to Organization

    If you’ve incorporated your business, then Apple will require you to register as a Corporation to have your app published on the App Store. If you submit your app under an Individual account in your name, it will be rejected.

    You must enroll as an organization if your company is a registered company such as Corporation (Corp., Inc.), Limited Liability Company (LLC, LC, Ltd. Co.), or a legal entity (GmbH, AG, KG, oHg, etc.).

    If you are a sole proprietorship you must register as an Individual. Apple does not accept DBAs, fictitious businesses, trade names, or branches for enrollment as a company/organizationBenefits of an Organization account:

    • You can invite developers to access your account
    • You can choose the name that will be displayed on the stores as the Developer of the app – this will match your company name e.g. Business Inc.
    • Apple will know you’re authorized to act for the company and will not challenge your use of your own brand name and content

    At Vendrux, our team of experts are here to hold your hand through every step of the app development and publishing process. Click here to learn more about how we can help.

    Convert your registration

    To change your account to a Corporate account, submit a request to Apple Developer Program Support.

    1. Navigate to the Contact Us form on Apple Developer’s Program pages.
    2. Log in with the Apple ID and Password
    3. Select your Region.
    4. Choose Account Updates and Renewals as your Subject.
    5. Enter a message with text along these lines

    “I’d like to convert my account from Individual to Organization. This will be our only Organization account. Here is the information regarding the company:

    – CEO/Director Name: First and Last Name.

    – Company Name: Your Company Name, including Ltd or Inc.

    – Account Type: Organization.

    – D-U-N-S Number: your Company’s DUNS number.

    – Address: Your Company’s Legal Address.

    – Phone Number: Your mobile phone or another phone number where you can be reached

    Apple will call to verify your enrollment. They’ll then send you an email with a link to a form for you to fill out more info about your Company.

    Organizations enrolling in the Apple Developer Program will need:

    Your business must be recognized as a legal entity (e.g., a corporation, limited partnership, limited liability company) to enter into the legal terms and obligations of Apple Developer Program. The legal entity name will appear as the developers for apps you distribute on the App Store. Example: Seller: ABC Company, Inc.

    You must have a D-U-N-S Number so that Apple can verify your organization’s identity and legal entity status. Learn more about what is a DUNS number and how you can get one for your company.

    You must have the legal authority to bind your organization to legal agreements. You must be the organization’s owner/founder, executive team member, senior project lead, or have legal authority granted to you by a senior employee.

    Your Company needs a public website and your domain name should be owned by the company.

  • How to configure the horizontal menu

    How to configure the horizontal menu

    The horizontal menu is displayed below the main header, where you can see your logo, hamburger menu and search icon.

    This menu will only work with categories, the idea is to give app users a quick way to navigate between the different categories of your app.

    Similarly to most menus in the Vendrux platform, you will need to create a WordPress menu and then assign it accordingly.

    So let’s get started with the configuration of your horizontal menu:

    1 – In your WordPress Dashboard, go to “Appearance > Menus” and click “create a new menu”.

    2 – You can now drag and drop the different types of links into the newly created menu

    3 – Once you have organized the menu according to your requirements make sure to save it

    4 – Now go to “Vendrux > Configuration” and access the “Menu” area

    With your menu created, you will want to assign it to the app, in case you have the tabbed menu disabled, or to a specific tab.

    Tabbed menu disabled

    If the tabbed menu is disabled in your app you will want to configure your horizontal menu in the following setting:

    Remember, this setting will only be displayed if the tabbed menu is disabled

    Tabbed menu enabled

    If the tabbed menu is enabled, you will be able to configure the horizontal menu individually for each one of your tabs, as you can see below:

    You will also want to adjust the First Item Label accordingly:

    This is the text that will be displayed in the first item of your horizontal menu, in this case, the tab’s content.

  • Configuring ads on vendrux News

    Configuring ads on vendrux News

    One of the most popular monetization methods for apps is to display ads in the content.

    We offer a few different ways for you to include your ads, below you can find more details about each one of them.

    1. Google Admob
    2. Google DFP
    3. HTML + Javascript embeds

    Google AdMob

    With our Google AdMob integration, you will be able to display banner ads in a fixed position at the bottom of the screen on list and article screens as well as interstitial ads every time a certain amount of posts has been viewed by the user.

    You can find the Google AdMob settings under “Vendrux > Configuration > Advertising” as you can see here:

    Scroll down a bit and you will find the settings to insert your AdMob App ID and ad units.

    The AdMob App ID is required in order for the ads to work.

    Here is a guide with more details on how to find your AdMob App ID: https://support.google.com/admob/answer/7356431

    With your AdMob App ID in place, you can now add the ad unit IDs for the placements you want to display:

    Make sure to configure the ad units for iOS and Android:

  • Common questions on OneSignal and GDPR compliance

    Does a OneSignal paid plan ($99/month) automatically opt out a customer of data collection in the app – data sharing with third parties?Yes, OneSignal‘s paid plans do not share any data with 3rd parties.If we use a free plan from OneSignal does that mean that an EU company would not be compliant with GDPR?Generally there are 2 options in working with OneSignal:

    1. Stay on the free plan and ask users to opt-in to share their data with services you use (including OneSignal).
    2. Upgrade your OneSignal Plan

    The first option keeps OneSignal free, but puts the burden on you to make sure users opt-in. The second option shifts the onus to OneSignal. For additional guidance on any specific GDPR responsibilities, we recommend working with your legal counsel.OneSignal’s paid plans do provide a DPA and model clauses which help provide the necessary legal framework for the data processing on your behalf and for EU-US data transfer. They work with many enterprise businesses in the EU/UK and this has not been an issue as long as the DPA is in place.