Developing workflow - simple
There are a number of different workflows you can use when developing and customising websites on the Neto by Maropost platform. This is a simple workflow which takes you through the step-by-step process that you'll need to get started.
Requirements
Before you get started, this simple workflow requires the following:
FTP Access
You will need FTP access to be able to edit the template files for your website. Find out how to get FTP access here.
Code Editor
FTP Client
With that being said, you're not restricted to any particular software suites when working with the Neto Platform.
Start A New Project
Once you have all of the above requirements in place, you can begin setup.
Step 1. Install Skeletal Theme
To ensure your new theme is using the most up to date theme code all custom themes should be built from our base template, Skeletal. In order to install the latest version of Skeletal, complete the following steps:
- From the Neto dashboard, navigate to Webstore > Theme editor.
Hover over
Skeletal
theme and click the Install button.If Skeletal is already installed, you'll need to click the arrow next to "Edit Styles" and click the Reinstall button. This is to ensure you're building on a fresh copy of Skeletal.
Step 2. Set up your FTP client
- As mentioned above, you will need FTP access in order to safely edit the files using a code editor. If you don't already have an FTP account for your website, you can request one here.
Providing you do have access, you simply need to setup a new account in Transmit, Filezilla, or your preferred FTP application, and connect:
- Protocol: SFTP
- Server: sftp.neto.net.au
- Username: myusername
- Password: ***
Once connected, navigate through your site's filesystem to the template/s you want to edit.
For example, to make changes to the header template, navigate to
/httpdocs/assets/themes/skeletal/templates/headers/template.html
To edit any of the themes CSS styles, the stylesheets are located under:/httpdocs/assets/themes/skeletal/css
-
httpdocs
-
assets
-
themes
-
skeletal
-
templates
templatesThis is where all of the HTML templates for your theme are stored.
-
cart
THEME_NAME/cartThis folder contains all of the templates related to your cart and checkout.
-
cart.error.html
THEME_NAME/cart/cart.error.htmlThis template contains the code for the various errors your customers can encounter during the checkout process.
-
empty.template.html
THEME_NAME/cart/empty.template.htmlThis page shows when the user navigates to their cart if they do not have any products added to cart yet.
-
includes
THEME_NAME/cart/includesIncludes are small templates that contain reusable code. These can also be dynamically refreshed with AJAX without reloading the page. These includes relate specifically to the checkout.
-
address.template.html
THEME_NAME/cart/includes/address.template.htmlThis is the section of the one-page checkout where the customer can configure multi-address checkout.
-
cart_items.template.html
THEME_NAME/cart/includes/cart_items.template.htmlThis template displays the order summary and coupon code interace on the right-hand side of the one-page checkout.
-
redeem_vouchers.template.html
THEME_NAME/cart/includes/redeem_vouchers.template.htmlThis template contains the redeem vouchers code towards the bottom of the one-page checkout.
-
shipping_options.template.html
THEME_NAME/cart/includes/shipping_options.template.htmlThis template contains the shipping options/calculator for the one-page checkout.
-
voucher_msg.template.html
THEME_NAME/cart/includes/voucher_msg.template.htmlThis is where the customer can define their gift voucher message on the one-page checkout.
-
address.template.html
-
invoice.template.html
THEME_NAME/cart/invoice.template.htmlThis is the page which shows directly after successfully completing the one-page checkout.
-
onepage.template.html
THEME_NAME/cart/onepage.template.htmlThis is the primary template for the one-page checkout. It calls a number of other templates from the includes folder.
-
quote_invoice.template.html
THEME_NAME/cart/quote_invoice.template.htmlThis is the page which shows directly after successfully submitting a quote through the one-page checkout.
-
shopping_cart.template.html
THEME_NAME/cart/shopping_cart.template.htmlThis is the template for the View Cart page.
-
upsell.template.html
THEME_NAME/cart/upsell.template.htmlThis is the template which displays upsells before the checkout. Will only display if configured correctly in the control panel.
-
voucher.template.html
THEME_NAME/cart/voucher.template.htmlThis is the template which lets users specify their gift voucher messages before they checkout. Will only display if configured correctly in the control panel.
-
cart.error.html
-
cms
THEME_NAME/cmsThis folder contains all of the templates for content pages. This includes the homepage, category pages, blogs, etc.
-
includes
THEME_NAME/includesIncludes are reusable templates which can be embedded anywhere on your site.
-
404.template.html
THEME_NAME/cms/404.template.htmlThis is the template for the 404 page. This page is cached more strictly than other pages, so changes may take time to take affect.
-
category.template.html
THEME_NAME/cms/category.template.htmlThis is the default template for all category pages.
-
default.template.html
THEME_NAME/cms/default.template.htmlThis is the default template for all content pages, including blogs and excluding the homepage.
-
home.template.html
THEME_NAME/cms/home.template.htmlThis is the default template for the homepage.
-
modal.template.html
THEME_NAME/cms/modal.template.htmlThis is the wrapper template for Modals.
-
products.template.html
THEME_NAME/cms/products.template.htmlThis is the template for the `/products` page. It lists out all categories in one place.
-
search_results.template.html
THEME_NAME/cms/search_results.template.htmlThis is the default template for all search results pages.
-
store_finder.template.html
THEME_NAME/cms/store_finder.template.htmlThis is the template for the stockist page, which can be setup in the control panel.
-
includes
-
customer
THEME_NAME/customerThis folder contains all of the customer/account specific pages.
-
approve_quote
THEME_NAME/customer/approve_quoteThis folder contains templates related to users approving quotes.
-
accept_quote_confirm.template.html
THEME_NAME/customer/approve_quote/accept_quote_confirm.template.htmlThis is a confirmation page which shows when the user chooses to approve a quote.
-
accept_quote_success.template.html
THEME_NAME/customer/approve_quote/accept_quote_success.template.htmlThis is a success page which shows when the user has approved a quote.
-
delete_quote_confirm.template.html
THEME_NAME/customer/approve_quote/delete_quote_confirm.template.htmlThis is a confirmation page which shows when the user chooses to delete a quote.
-
delete_quote_success.template.html
THEME_NAME/customer/approve_quote/delete_quote_success.template.htmlThis is a success page which shows when the user has deleted a quote.
-
template.html
THEME_NAME/customer/approve_quote/template.htmlThis page lists all active quotes and gives customers the option to either approve or delete their quotes.
-
accept_quote_confirm.template.html
-
edit_account
THEME_NAME/customer/edit_accountThis is where the edit account templates are stored.
-
edit_address
THEME_NAME/customer/edit_addressThis is where customers can manage their shipping addresses and even store multiple addresses.
-
edit_pwd
THEME_NAME/customer/edit_pwdThis is where customers can manage their password.
-
favourites
THEME_NAME/customer/favouritesFrom this page customers can reorder products which they have previously ordered.
-
files
THEME_NAME/customer/filesNeto lets you upload files such as contracts to customer cards. If configured correctly in the control panel, customers can view and download these files from the accounts page.
-
template.html
THEME_NAME/customer/files/template.htmlThis page shows if the customer has no files uploaded to their user card.
-
view.template.html
THEME_NAME/customer/files/view.template.htmlFrom this page customers can view and download the files attached to their customer card in the control panel. Users cannot upload their own files.
-
template.html
-
forgotpwd
THEME_NAME/customer/forgotpwdTemplates related to resetting a forgotten password are stored here.
-
forgotusr
THEME_NAME/customer/forgotusrTemplates related to resetting a forgotten username are stored here.
-
login.template.html
THEME_NAME/customer/login.template.htmlThis is the template for the log-in page. By default it is identical to the register page though the register form can be removed from this page if required.
-
logos
THEME_NAME/logosIf configured correctly customers can upload their logo to their customer card. This is specifically designed for dropshipping.
-
logout.template.html
THEME_NAME/customer/logout.template.htmlThis page shows when the customer has successfully logged out.
-
mystore
THEME_NAME/mystoreYour customers can be your stockists! They can manage their store from this section of the accounts page and it will display them on your stockist finder.
-
edit.template.html
THEME_NAME/mystore/edit.template.htmlFrom this page customers can change stockists that they have already setup.
-
template.html
THEME_NAME/mystore/template.htmlThis page shows if the customer does not have permission to add and modify stockists.
-
view.template.html
THEME_NAME/mystore/view.template.htmlFrom this page customers can view, add and edit stockists.
-
edit.template.html
- nr_print
- nr_track_order
- nr_view_order
-
pay_order
THEME_NAME/customer/pay_orderCustomers can pay off orders with real-time payment methods in this section of their account.
-
pay_now_confirm.template.html
THEME_NAME/customer/pay_order/pay_now_confirm.template.htmlThis page contains the form for paying off orders. Users typically get here from the accounts home.
-
pay_now_success.template.html
THEME_NAME/customer/pay_order/pay_now_success.template.htmlThis page displays when the customer has successfully applied payment to an order through their account.
-
pay_now_confirm.template.html
-
payrec
THEME_NAME/customer/payrecThis is where customers can apply payment to orders in bulk.
-
print
THEME_NAME/customer/printThis folder contains templates for when registered customers print their orders from the accounts page.
-
template.html
THEME_NAME/customer/print/template.htmlThis is effectively the 404 template for printing invoices. It will show if the user is not logged in or if the order does not exist.
-
quote.template.html
THEME_NAME/customer/print/quote.template.htmlThis template acts as a wrapper for the page when registered customers print their quotes from the accounts page.
-
order.template.html
THEME_NAME/customer/print/invoice.template.htmlThis template acts as a wrapper for the page when registered customers print their invoices from the accounts page.
-
template.html
-
register
THEME_NAME/customer/registerThis folder contains templates for the customer registration process.
-
resetpwd
THEME_NAME/customer/resetpwdFrom here customers can complete the registration process after submitting their first order. When they do so, they receive an email asking if they'd like to set a password for the user we have automatically created for them.
-
template.html
THEME_NAME/customer/template.htmlThis is the index page for user accounts. It features a summary of recent orders as well as links to the other customer-centric pages.
-
track_order
THEME_NAME/customer/track_orderThis is the success page which shows after the user has successfully set their password.
- view_order
- vouchers
- warranty
- wholesaleregister
- wishlist
- write_contentreview
- write_review
-
approve_quote
-
footers
THEME_NAME/footersThis is where the templates for your websites footers are stored. Every page has both a header and a footer.
-
headers
THEME_NAME/headersThis is where the templates for your websites headers are stored. Every page has both a header and a footer.
-
netothemeinfo.txt
THEME_NAME/netothemeinfo.txtThis file includes the description, name and version details for your theme.
-
products
THEME_NAME/productsThis folder contains all of the templates for your product pages.
-
includes
THEME_NAME/products/includesIncludes are reusable templates which can be embedded anywhere on your site. This particular folder is specifically reserved for the product pages AJAX templates.
-
buying_options.template.html
THEME_NAME/products/includes/buying_options.template.htmlThis template features the standard add-to-cart interface and the shipping calculator. By default, it shows on all products that either have variations, or don't have variations AND don't have editable components.
-
child_products.template.html
THEME_NAME/products/includes/child_products.template.htmlThis template features the default child product interface. It shows on parent products that have children, but don't have variations.
-
components.template.html
THEME_NAME/products/includes/components.template.htmlThis template includes the interface for editable kits.
-
header.template.html
THEME_NAME/products/includes/header.template.htmlThis template includes the pricing, product title and sale/stock details.
-
images.template.html
THEME_NAME/products/includes/images.template.htmlThis template includes the product images.
-
buying_options.template.html
-
template.html
THEME_NAME/products/template.htmlThis is the primary template for your product pages. It wraps the various AJAX templates/includes and contains additional generic layout code.
-
includes
-
thumbs
THEME_NAME/thumbsAdvert and Thumblist tags utilise thumbnails for their layout. All thumbnails are located in this folder.
-
cart
-
css
THEME_NAME/cssYour themes CSS files are stored in here.
-
app.css
THEME_NAME/css/app.cssThis is the compiled source-file for the Neto base template. Do not edit this file.
-
style.css
THEME_NAME/css/style.cssThis is the CSS specifically for the theme. This is the best place to put custom styles.
-
style.info.txt
THEME_NAME/css/style.info.txtThis file contains information on the customisable variables of the theme. It is parsed by the theme editor in the control panel.
-
app.css
-
js
THEME_NAME/jsYour themes JavaScript files are stored in here.
-
scss
THEME_NAME/scssYour themes uncompiled SCSS files are stored in here.
-
templates
-
skeletal
-
themes
-
assets
-
httpdocs
In your FTP client, right-click on the file you want to edit and open with your chosen code editor. You can now make the necessary code changes and save the file. If you're using Transmit, it will have automatically uploaded. Otherwise, you may need to manually upload the file in your chosen FTP application.
In order to see the changes, ensure the
skeletal
theme is set as your active theme and refresh your website's cache. This can be done from any page in the control panel, by clicking the 'Refresh caches' link in the sidebar.
Want to name your theme? At any point rename the skeletal
folder under /httpdocs/assets/themes
to your preferred theme name. This should not contain any spaces or special characters, use dashes -
or underlines _
for spaces if needed. If you do this locally and upload the new theme folder you will now have your new theme as well as the previous skeletal
theme which can be handy for very basic version control or theme history.
When a theme folder name changes, this will reflect in the control panels Webstore Settings and Theme Editor, set your new theme name as the active theme or use the nview={theme_name} URL query to see the new theme in your browser (if all you've done on this occassion is change the theme folder name, there won't be any visible changes yet).