Tools · Downloads

The Downloads module through the assistant: setting up the space (repository or one file only, categories, approval), creating the item, uploading the files by link or file, publishing, seeing what you can download and the team's counters.

Each tool carries a badge: Read-only changes nothing, Changes creates or changes something right away, and Asks to confirm only acts after your yes to a summary. See Money and confirmation.

#In short

The space is created with create_space and module: "downloads". Who can upload is the space's Who can post (update_space_access): by default, only the team. The item's price is set on the product created with it (update_product, update_price, publish_product; see Sales and plans).

#get_downloads_space_settings

Read-only

Space settings. The mode (multi, repository; single, one file only), whether members' items wait for approval, and the categories (id, name and how many items). Minimum role: anyone who sees the space.

Ask like this: "How is the Materials space set up?"

#update_downloads_space_settings

Changes

Set up the space. Changes the mode, the approval and the categories. Only what you send changes. Minimum role: admin.

Read get_downloads_space_settings first, to get the ids.

Ask like this: "In the Materials space, create the Spreadsheets and E-books categories and require approval for what members upload."

#list_download_items

Read-only

The space's items. Newest to oldest: title, category, files and status. The team and the author also see drafts and items in review. A paid item the person hasn't bought comes back locked: it shows the price and the product, without files. Minimum role: anyone who sees the space.

#get_download_item

Read-only

One item. Description, category, files (id, name, type, size and, for the team, how many downloads), status and the product (price, whether it's free, whether it's sold out and your place on the waitlist). A locked item shows no files. Minimum role: anyone who sees the space.

#create_download_item

Changes

Create an item. Creates the item as a draft, with its product (Download kind, free, draft), returned in product. Then: upload the files with upload_download_file, set the price with update_product and publish with update_download_item. Role: whoever the space's Who can post allows; by default, the team (a member gets 403).

In a space in single mode, a second item is refused (409). Members' items wait for approval when the space requires it.

Ask like this: "In the Materials space, create the item Cash flow spreadsheet, in the Spreadsheets category."

#update_download_item

Changes

Edit and publish. Changes the title, description, category, stamp_pdf, the cover (remove_cover removes it) and the status (status: draft or published; publishing requires at least one file). Only what you send changes. Role: the author and the team.

Ask like this: "Publish the Cash flow spreadsheet item and turn on the PDF stamp."

#delete_download_item

Asks to confirm

Delete the item. Deletes the item and its files; its product is archived. It's refused (409) while a paid purchase still gives access: refund it first. Role: the author and the team.

Returns: on the first call, the summary of what will be deleted and the confirmation code.

#upload_download_file

Changes

Upload a file. Adds a file to the item, by public link or by base64. It accepts images (PNG, JPG, WEBP, GIF), spreadsheets (XLS, XLSX, ODS, CSV), PDF, documents (DOC, DOCX, ODT, TXT, MD, PPT, PPTX) and ZIP, never executables; the name must keep its extension and the content must match the type (checked by the first bytes), just as in the browser. Role: the author and the team.

In single mode, the item keeps a single file: to upload again, pass replace_file_id. The storage usage notice only warns.

Ask like this: "Upload https://exemplo.memberfy.net/fluxo.xlsx to the Cash flow spreadsheet item."

#remove_download_file

Asks to confirm

Remove a file. The file is deleted and the storage comes back. If it was the last one of a published item, the item goes back to draft. Role: the author and the team.

#reorder_download_files

Changes

Reorder the files. file_ids is the complete list, from first to last. Role: the author and the team.

#get_download_url

Read-only

A file's link. A link that works for 5 minutes. Ask for it only when the person really wants the file; don't store or pass it on. The team and the author always get it; everyone else needs access (free item, active purchase or plan that includes the product; having downloaded it before isn't enough). Minimum role: anyone who sees the space.

Returns: the link and stamped: true when it's the copy with the stamp (only for people outside the team), false when it's the original. Each member download counts toward the counters.

A paid item the person doesn't have returns 403, with the price (the purchase is made in the app); a sold-out item returns 409, and the assistant suggests join_waitlist.

#list_my_downloads

Read-only

Your downloads. The items you can open, with where the access comes from (purchase, plan, open, team), your last download and, for a purchase, the date and the end of access. Minimum role: any.

#get_download_stats

Read-only

The item's counters. How many times each file was downloaded, in total and by distinct people. Only numbers, never who. Minimum role: moderator (or finance).

#Related

• Downloads
• Tools
• Money and confirmation